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Avant-propos 



PHP n'a pas dix ans. Malgre le succes incontestable qui fait de ce langage 
l'un des premiers outils du Web - et le module Apache le plus installe, cer- 
tains peinent encore a reconnaitre en PHP un environnement et langage 
professionnel pour des applications d'entreprise. 

II est vrai que depuis l'explosion de la bulk Internet, le monde des nouvelles 
technologies (TIC) est entre dans une phase d'industrialisation equivalente a 
celle que le secteur informatique dans son ensemble a entamee depuis pres 
d'une decennie. Les utilisateurs d'informatique et de solutions TIC atten- 
dent desormais des offres et des methodes qui, au-dela de l'approche 
« prototype » qui prevalait, demontrent tout au contraire leur fiabilite et leur 
robustesse. 

Cette exigence impose naturellement la mise en oeuvre d'outils ou methodes 
adaptes, a meme de simplifier et de securiser le processus de developpement. 
C'est le cas du modele objet, des design patterns et des frameworks de deve- 
loppement tres en vogue aujourd'hui. Dans ce contexte, la version 5 de PHP 
devrait rallier les plus reticents. 

PHP est en effet sur le point de parvenir a allier a sa simplicite d'utilisation 
et de mise en oeuvre, une grande richesse fonctionnelle en se dotant d'un 
veritable support du modele objet, de capacites de specification et d'un sup- 
port XML enfin mur. Autant de raisons de voir PHP gagner en popularite, y 
compris dans les projets les plus critiques. 



Quel est I'objectif de cet ouvrage ? 



L'annexe B fournit des elements sur les extensions 



Ce cahier du programmeur propose une mise en pratique simple mais carac- 
teristique des fonctionnalites cles de PHP en matiere de developpement 
web, qu'il s'agisse des nouveautes apportees par PHP 5, ou de fo notions deja 
presentes dans PHP 4 que leur complexity apparente ou reelle avait pu des- 
servir. 

Loin des bibles qui peinent a s'eloigner des manuels de reference disponibles 
pour PHP, cet ouvrage ne vise en aucun cas l'exhaustivite, bien au contraire : 
retenues dans PHP 5 plutot que d'egrener la litanie des fonctions et des extensions, I'objectif est de 

proposer au lecteur une synergie avec le manuel de reference de PHP ou les 
livres de references existant sur ce sujet. 

Les concepts cles sont mis en pratique dans le cadre d'une etude de cas que 
nous avons choisie simple mais fonctionnellement riche : un systeme de chat. 
Par cette mise en situation, nous nous attachons a faire connaitre les possibi- 
lites exceptionnelles de PHP, mais aussi a les rendre plus simples a appre- 
hender. 

Cette demarche, que Ton pourrait qualifier d'initiatique sur des sujets phares 
du developpement web, tente d'offrir les moyens et le socle pour approfondir 
ses connaissances, en tirant notamment parti de la source d'informations 
inepuisable que constitue le manuel de reference PHP et les livres de refe- 
rence qui existent sur le sujet. 



Cet ouvrage est-il accessible a un lecteur debutant 
en PHP ? Oui, mais il lui faudra une attention par- 
ticuliere et de la methode, et ne surtout pas negli- 
ger le chapitre d'introduction. 



A qui s'adresse cet ouvrage ? 

Cet ouvrage s'adresse a tous les utilisateurs de PHP. Au-dela de l'aspect syn- 
taxe du langage, il se penche sur les elements cles de toute application web 
ambitieuse : gestion des sessions utilisateur, internationalisation, etc. II pro- 
pose egalement un tour d'horizon des aspects techniques les plus pointus 
pour realiser des developpements de qualite : utilisation des interfaces, para- 
digme objet, XML. . . 



Comment lire cet ouvrage ? 

Pour decouvrir le potentiel de la nouvelle version de PHP, nous deroulerons 
tout au long de l'ouvrage une etude de cas qui nous servira de fil conducteur. 
Mais attention, que vous soyez debutant PHP ou amateur averti, ne faites 
pas l'impasse sur le chapitre d'introduction, qui est l'occasion de (re)decou- 
vrir les bases du langage... peut-etre certains elements surprendront-ils ceux 



VI 



qui pensent deja bien connaitre PHP. Passee cette etape, chacun pourra 
devorer le chapitre de son choix. 

Les adeptes du modele objet pourront sans nul doute jeter leur devolu sur les 
chapitres 2, 4 et 6. Les chapitres 7 a 10 devraient pour leur part recueillir les 
suffrages de ceux qu'XML a conquis, ou qui attendent d'etre conquis par lui. 
Les chapitres 5 (sessions utilisateur), 12 (internationalisation) ou encore 13 
(options avancees), peuvent etre lus et relus ponctuellement pour decouvrir 
un sujet ou se rafraichir la memoire. 

Certains chapitres sont plus difficiles d'approche que les autres, c'est le cas 
des chapitres consacres a l'objet et a XML. Le lecteur debutant pourra dans 
ce cas proceder en deux temps : un premier survol, accompagne de quelques 
tests cles, puis, en fonction des besoins, une relecture plus fine de certains 
aspects evoques. 

Enfin, l'ouvrage se complete de quatre annexes indispensables : l'annexe A 
resume ce qu'il faut savoir pour heberger son serveur PHP a domicile, 
l'annexe B parcourt les extensions standards integrees a PHP, l'annexe C 
rappelle l'essence de la norme DOM et enfin, l'annexe D offre un recapitu- 
latif de la structure du code associe a notre etude de cas. 



Ou trouver le code associe 
a cet ouvrage ? 



L'integralite du code source est disponible en tele- 
chargement sur le site de I'auteur. Par ailleurs, une 
mise en situation reelle de I'application avec son 
code source est aussi disponible pour des tests. 

► http://www.stephanemariel.com 

► http://www.phpsaloon.com 
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http://fr.php.net/monuol/cnyrcf.my3ql.php 



2_ ^.Scorch ^ " [ 



MYSQL ASSOC : "" "" 

^ ~ | array index 



MYSQL_BOTH 



columns are returned into the array having both a numerical index 
and the fieldname as the array index. 



Columns are returned into the array having a numerical index to the 
fields. This index starts with 0, the first field in the result. 



Examples 

i his simple example shows how to connect, execute a query, pnnt resulting rows and 
disconnect from a MySQL database. 

Example 1. MySQL extension overview example 



<?php 

/* Connectinq, selectinq database */ 

Slink = mysql_connect ("roysql_host", "roysql_user", "mysql_password") 

or die ("Could not connect : " . raysql_error ( ) ) ; 
echo "Connected successfully"; 

mysql_«p 1 prrt_Hb ( "my_rlatahftsp"j nr HipfCnulH nnt splprrt Hahp.ha«*p") ; 

/* Performing SOL query */ 

Squcry - "SELECT * PHOM my_toblc"; 

Srcoult — myoql query ($ query) or dic("Qucry foiled : " . royoql error ()) ; 



/* PLiiiLiuy Lcsull3 in HTML */ 
echo "<table>\n"; 

while (Slme = mysql_fetch_array(:fresult, MJ£SOi_ASS<JC) ) ( 

echo "\t<tr>\n": zi 

Fo^S 5 /,. 



Introduction lapidaire 



a PHP 



PHP a l'immense avantage d'etre facile a apprehender. 
Avant d'entrer dans notre etude de cas, quelques 
rappels nous ont paru indispensables pour bien 
demarrer et prendre en main les elements cles du noyau 
dur de PHP 

extensions 

MOTS-CLES 

► Structures de controle 

► Variables « superglobales » 

► ChaTnes dynamiques 



SOMMAIRE 

PHP, langage de script 

PHP, langage a la syntaxe 
conventionnelle 

► PHP, fenetre ouverte sur le Web 

P PHP. lannane done nar ses 



PHP vous est inconnu ou vous avez besoin de raviver votre experience ? 
Cette prise en main est faite pour vous. Fort des quelques elements cles qui 
constituent le noyau dur de PHP, vous aurez acces a tout le potentiel du lan- 
gage. Mais chaque chose en son temps, partons pour un petit tour d'horizon 
pratique. 



PHP, un langage immerge dans les 
documents 

Dans la plupart des cas, les langages de programmation sont concus pour 
etre mis en oeuvre isolement. D'un cote, le code des programmes, de l'autre, 
des informations. PHP, qui s'inscrit d'emblee dans une logique web, est de 
ce point de vue totalement different. A la difference des langages comme C, 
Java voire Perl, PHP est prevu pour etre integre directement dans des docu- 
ments (HTML, XML). 

Pour cette raison, il est necessaire de distinguer, dans un fichier PHP, les 
informations statiques (squelette de page HTML, par exemple) du code 
PHP lui-meme. Par chance, le W3C a tout prevu, et pas seulement pour 
PHP, mais pour tout langage ayant vocation a etre immerge dans des docu- 
ments web. 

Ainsi, le W3C definit des sequences d'echappement qui delimitent les fron- 
tieres entre le code et l'information classique. Le code est alors designe sous 
le terme de processing instructions. Deux syntaxes sont possibles. La plus ver- 
beuse, rarement utilisee avec PHP (ou ASP), ne vous est cependant pas 
inconnue car elle est malgre tout tres utilisee, notamment avec JavaScript : il 
s'agit de delimiter le code avec la balise scri pt. 

<html> 
<head> 
<title> 

Premiere page dynamique en PHP 
</title> 
</head> 
<body> 

Cette phrase est un contenu statique. <br/> 
<script language="PHP"> 

print "Mais ceHe-ci est dynamique. <br/>"; 
</scri pt> 

Et ceHe-ci de nouveau statique. 
</body> 
</html> 

Cette syntaxe est valide pour l'ensemble des langages, JavaScript cote client, 
ou ASP et PHP cote serveur. 



r ) Premiere page dynamique en PHP - Mozilla Firefox 




File Edit View Go Bookmarks lools Help 
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Cette phrase est un contenu statique. 




Mais celle-ci est dynamique. 




Et celle-ci de nouveau statique. 




Done 





Figure 1 Premiere page dynamique avec PHP 



II existe neanmoins une syntaxe raccourcie plus repandue dans le cas de 
PHP. Le debut du code est marque par <?php et la fin par ?>. De maniere 
plus generale, la syntaxe est de la forme <?X ... ?> oiiX represente le langage 
dans lequel est ecrit le code. Notre exemple peut alors s'ecrire : 

<htm~l> 
<head> 
<title> 

Premiere page dynamique en PHP 
</title> 
</head> 
<body> 

Cette phrase est un contenu statique. <br/> 

<?php 

print "Mais celle-ci est dynamique. <br/>" ; 

?> 

Et celle-ci de nouveau statique. 
</body> 
</html> 

Cette syntaxe, deja tres simple, peut encore etre raccourcie en supprimant le 
php de la balise d'ouverture. Toutefois, cette derniere version, quoique tres 
utilisee, n'est pas vraiment orthodoxe et peut entrer en collision avec d'autres 
declarations comme celle de la declaration initiale des documents XML. 
Mieux vaut done taper trois caracteres de plus. 

Comme le montrent nos deux premiers exemples, le code PHP est totale- 
ment immerge dans l'information. Un document PHP pourrait meme 
d'ailleurs ne pas contenir de code (pour une phase de test) et etre totalement 
statique. Progressivement, il sera possible d'ajouter ici ou la dans le docu- 
ment des instructions PHP, car il n' existe pas de limites quant au nombre ou 
au positionnement du code PHP dans le document. Celui-ci peut etre utilise 
pour obtenir tout un morceau HTML, un simple attribut ou construire 
dynamiquement un tableau. 
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REGARD DU DEVELOPPEUR 
PHP en ligne de commande 

Meme si PHP a ete congu dans une logique web, 
rien n'interdit de creer des documents entierement 
PHP. Dans ce cas, le premier element du document 
est la balise <?php et le dernier la balise ?> car, 
quoi qu'il arrive, un document est toujours ouvert 
en mode statique et lu comme tel jusqu'a ce que 
Ton rencontre du code PHP. 
Enfin, si PHP est le plus souvent utilise en associa- 
tion avec un serveur web, rien n'interdit de s'en 
servir en ligne de commande pour creer ses pro- 
pres applications. II existe d'ailleurs une version de 
PHP couplee a la bibliotheque graphique GTK pour 
construire des applications autonomes. 
► http://gtk.php.net/ 
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Une syntaxe simple 



COMPRENDRE Expressions et instructions 

En PHP comme en C, les instructions sont le plus 
souvent percues comme des expressions et peu- 
vent etre integrees dans des expressions plus com- 
plexes. 



Nos premiers exemples le demontrent, la syntaxe de PHP n'est vraiment pas 
difficile et tient en quelques regies simples : 

• Les instructions sont separees par un « ; » (comme dans la plupart des 
langages senses). 

• Le langage n'est pas sensible a la casse des caracteres (majuscules, minus- 
cules). 

• Les variables sont designees par leur nom, precede du symbole « $ » 
(comme en Shell) et PHP n'est pas type. Une variable peut done contenir 
toute information, quelle que soit la nature de celle-ci. Exemple : 
Sniveau, Smessage. 

• II n'est pas necessaire de declarer les variables, meme si cela reste possible 
avec l'instruction var. Plusieurs instructions peuvent etre regroupees dans 
un bloc pour former une instruction composee ; le bloc est alors delimite 
par des accolades (« { » et « } »), la encore, comme dans la grande majo- 
rite des langages courants. 

• Les commentaires peuvent etre introduits a la maniere de C++ sur une 
seule ligne avec « // » ou comme dans C avec « /* » et « */ ». 

On le voit, PHP ne mise pas sur l'originalite et si vous avez deja experimente 
un langage de programmation parmi les grands standards, vous ne risquez 
guere d'etre decontenance. 

Du cote des expressions, PHP supporte grosso modo le meme jeu d'expres- 
sions que le langage C. Les operateurs logiques sont comme en C « == » 
pour la comparaison, « && » pour le « et logique » et « | | » pour le « ou ». 
Les adeptes de Pascal ou d'Ada pourront neanmoins utiliser « or » et 
« and ». PHP dispose, en outre, de la tres grande majorite des fonctions 
numeriques et des operations sur les bits. 

ASTUCE Quelques raccourcis de syntaxe 

PHP copie C encore sur un autre point : la possibility de recourir a des syntaxes raccourcies 
pour certaines petites instructions courantes : 



Forme classique 


Forme raccourcie 


$X = $X + $Y; 


$X += $Y; 


$X = $X - $Y; 


$X -= $Y; 



Comme on peut s'y attendre, cette syntaxe s'etend a la multiplication et a la division, ainsi 
qu'aux operateurs logiques. 

Enfin, PHP supporte aussi les syntaxes du type $X++ (respectivement $X--) pour incremen- 
ter (respectivement decremented une variable. 



Des types elementaires... mais pas de 
typagc 



Nombres et caracteres 

Si chaque variable en PHP peut contenir indifferemment tout type d'infor- 
mation, PHP n'en propose pas moins les types elementaires et traditionnels : 

• booleens ; 

• nombres ; 

• chaines de caracteres. 

En PHP, tous ces types peuvent etre manipules comme des chaines de 
caracteres ; la conversion est alors transparente. De meme, les booleens true 
et f al se peuvent implicitement etre convertis en 1 et 0 au besoin. 

Les chaines de caracteres sont representees soit entre apostrophes simples 
{quotes) « 'chaine' », soit entre guillemets (« "chaine" »). La distinction 
entre les deux representations est importante car nous verrons par la suite 
que l'utilisation des guillemets se prete a divers raffinements. Par defaut, le 
plus sage et le plus performant est toujours d'utiliser les apostrophes simples 
{simple quotes). 

Lacces a chaque caractere d'une chaine s'effectue en utilisant les accolades , 
par exemple, si $val eu r contient une chaine de caracteres, alors le deuxieme 
caractere peut etre obtenu via $valeur{l}. Attention, PHP ne dispose pas du 
type caractere, le resultat est done une nouvelle chaine de caracteres. La 
fonction strlenO permet de connaitre la taille d'une telle chaine. 

Tableaux 

Si les types de donnees disponibles dans PHP peuvent paraitre simplistes, la 
notion de tableau proposee est tres riche et permet de creer des tableaux 
associatifs dynamiques et multi-dimensionnels. 

II n'est pas necessaire de declarer un tableau. La simple affectation d'un ele- 
ment provoque la creation implicite d'un tableau et son stockage dans la 
variable. Lacces a un element particulier se fait en utilisant les crochets. 

Dans l'exemple suivant : 



$a[6] = 7; 



A RETENIR Utilisez les quotes ou les 
guillemets pour les index de type texte 

Quand I'index d'un element dans un tableau est 
une chame de caracteres, il est possible d'utiliser 
$a[rouge] etnon $a[' rouge'] pouraccedera 
I'element. 

Ceci n'est en realite qu'une tolerance (PHP recher- 
chant dans le premier cas une constante nommee 
rouge) et nous le deconseillons tres fortement. 



La variable $a contient alors un tableau d'un seul element (dont la cle d'acces 
est 6). II est alors possible d'ajouter autant d'elements que souhaite, voire 
d'ajouter des dimensions. 

$a[9] ['couleur'] = 'rouge'; 
$a['element'] = 'oxygene'; 

Ici, nous avons ajoute une deuxieme dimension, $a[9] est alors un tableau. 
Par ailleurs, l'indexation des tableaux ne se limite pas aux seuls entiers. 

La fonction print_r() permet d'obtenir une representation texte d'un 
tableau comme le montre la figure 2. La fonction var_dump() disponible pour 
tous les types de donnees permet d'obtenir encore davantage d'informations. 



*0 Premiere page dynamique en PHP - Mozilla Firefox 


rrr 




File Edit View Go Bookmarks lools Help 


® ' ^ * © | http://10.128.0.251/v2/scrtpt,php 




Contenu de la variable Sa avec print r() : 
Array 






( 

[6] => 7 

[9] => Array 

( 






[couleur] => rouge 

) 






[element] => oxygene 






) 

Contenu de la variable $a avec var dump ( ) : 
array (3) { 

[6] => 

int (7) 

[9] => 

array (1) { 

[ "couleur"] => 
string (5) "rouge" 

} 






[ "element"] => 
string (7) "oxygene" 

> 






Done 







Figure 2 Structure d'un tableau avec pri nt_r() et var_dump() 



Enfin, la fonction arrayO definit un tableau de maniere globale, qu'il soit 
associatif ou non : 

Stableau = array( 'element 0', 

'fruit' => 'pomme', 
array( 'message' => 'Bonjour', 
'code' => 3)) ; 

Dans cet exemple, ' el ement 0 ' va se voir attribuer I'index 0, faute d'avoir un 
index impose. II en va de meme pour le troisieme element, qui est un 
tableau. 
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Le resultat presente par print_r() est le suivant : 



Array 
( 



) 



[0] => element 0 
[fruit] => pomme 
[1] => Array 
( 

[message] => Bonjour 
[code] => 3 

) 



L'instruction unset () peut alors etre utilisee pour supprimer un element du 
tableau : 

| unset ($tableau['f ruit']) ; 

Cette meme instruction peut tout autant supprimer une variable classique ou 
etre utilisee en collaboration avec isset() qui determine pour sa part l'exis- 
tence ou non d'une variable ou d'un element de tableau. 



Sous-programmes et modularity 

II va de soi qu'un programme PHP consequent ne se limite pas a quelques 
instructions executees en sequence. Comme l'ensemble des langages, PHP 
permet de definir des fonctions. La syntaxe utilisee est la suivante : 

// une fonction foo() 

function foo($paraml, $param2, $param3 = 45) { 
// code de la fonction 
return $paraml+$param2 ; 

} 

// procedure bar() 
function bar(Sparaml) { 

// code de la fonction bar sans return, 

// ou avec un return sans parametre. 

} 

II n'est fait aucune difference entre procedures et fonctions au niveau de cette 
syntaxe. Dans les fonctions, on utilisera l'instruction return pour terminer 
l'execution et retourner le resultat. 

Pour aller plus loin en termes de modularite, PHP permet d'inclure des 
fichiers avec quatre instructions distinctes : 

* include 

* indude_once 

• require 

• require_once 



ARETENIR Acceder aux variables globales 
depuis une fonction 



Dans une fonction, seules les variables definies 
localement ou les parametres sont accessibles. 
Pour acceder aux variables definies dans le corps 
principal du programme il faut utiliser l'instruction 
global : global Smavariableglobale; 
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Ces quatre versions correspondent en realite aux combinaisons de deux 
variantes : 

• requi re declenche une erreur et arrete le programme si le fichier inclus 
n'est pas trouve. include se contente de provoquer un avertissement. 

• les versions « _once » gerent les risques d'inclusions multiples. Avec 
inc~lude_once (comme avec requi re_once), PHP s'assure que chaque 
fichier n'est inclus qu'une seule et unique fois, meme si plusieurs deman- 
des sont faites. 

Dans la pratique, on utilisera de preference l'instruction requi re_once (sauf 
besoins specifiques) car elle presente le maximum de garanties. 

II faut retenir que les fichiers inclus sont traites de facon rigoureusement 
identique a tout fichier PHP standard. L'interpreteur PHP commence done 
l'analyse du document en mode « contenu statique ». Comme dans un 
fichier classique, il faudra done utiliser les balises <?php et ?> pour entourer le 
code PHP. 

Fichier principal 

<? 

requi re_once' module.php' ; 

foo(); 

?> 

Fichier module.php correct 

<? 

function foo() { 
return 'Hello' ; 

} 

?> 

Fichier module.php incorrect 

function foo() { 
return'Hello' ; 

} 

Pour les modules composes uniquement de code PHP (e'est le cas des 
bibliotheques de fonctions), la balise <?php sera positionnee au tout debut du 
fichier et ?> a la fin. 

Une source tres repandue d'ennuis consiste d'ailleurs a oublier, soit sur la 
premiere ligne (avant <?php), soit en fin de fichier (apres ?>) des blancs 
(espaces, tabulations) ou des retours a la ligne. Lors de l'inclusion, ces carac- 
teres parasites seront affiches dans le document HTML final. Avec, a la cle, 
des problemes de mise en page et tres souvent des problemes d'en-tete 
HTTP (comme pour les sessions). 



Les structures de contrdle habituelles 



Pour decrire la structure algorithmique de votre programme, PHP propose 
la panoplie complete des structures de controle habituelles : 

• for, 

• while et do/while, 

• if et if/else, 

• switch. 

En termes de syntaxe, PHP reste tres conventionnel (voir l'exemple ci- 
apres). Dans tous les cas de figure, une instruction simple peut etre rem- 
placee par un bloc d'instructions entre accolades. 

// Test simple : 
if ( $i == 0 ) 

print'I est nul ' ; 
// Test avec alternative, 
if ( $i == 3 ) 

print'I vaut 3' ; 
else 

print'I est different de 3'; 
// Tests multiples 
switch($i) { 
case '3' : 

print'I vaut 3' ; 

break; 
case'foo' : 

print'I est une chaine et vaut foo."; 

break; 
default: 

print'I est banal . ' ; 

} 

Dans le cas de l'instruction switch, on veillera a ne pas omettre break, sauf 
cas particulier. A defaut, plusieurs alternatives seront agglomerees. 

switch($i) { 
case ' 3 ' : 

print'I vaut 3' ; 
case'foo' ; 

print'I est une chaine et vaut foo."; 

break; 
default: 

print'I est banal . ' ; 

} 

// Si $i contient la valeur 3, affichera : 
// I vaut 3. 
// mais aussi 

// I est une chaine et vaut foo. 



Svaleur prend successivement les valeurs vl, ► 
v2, v3. 

Dans cette adaptation, la cle et la valeur sont ► 
disponibles a chaque instant, $cle prendra les 
valeurs rouge, 9,foo. 

Pour chaque tableau, une variable interne indi- ► 
que I'element courant. Reset () repositionne ce 
pointeur en debut de tableau. 

Each() retourne la ligne courante du tableau ► 
(sous la forme d'un tableau de deux elements : 
cle et valeur. En outre, le pointeur interne est 
avance d'une ligne. 



Les structures de boucles sont, elles aussi, tres conventionnelles : 

for($i = 0; $i < 10; $i++) { 
print "Le compteur vaut $i\n"; 
// ... 

} 

$i = 0; 

while ($i < 15) { 

print "Le compteur vaut $i\n"; 
$i++; 

} 

On peut sortir du mode PHP a tout moment, pour revenir au contenu sta- 
tique, ce qui peut surprendre de prime abord : 

<table> 

<?php 

for($i = 0; $i < 10; $i++) { 
?> 

<trxtdx?php print "Le compteur vaut $i\n"; ?></tdx/tr> 
<?php 
} 

?> 

</table> 

Ici, chaque iteration de la boucle produit une ligne dans une table HTML. 
Cette segmentation du code peut etre utilisee partout en PHP. On peut 
done creer un squelette HTML et intercaler le code PHP necessaire aux 
bons endroits. Toutefois, dans le cas particulier des boucles, cet usage n'est 
pas recommande si Ton souhaite conserver le maximum de performances (et, 
accessoirement, de lisibilite). 

II est enfin possible d'optimiser le parcours des tableaux en PHP avec des 
instructions particulierement adaptees comme foreach et each : 

Stableau = array ( 'rouge' => 'vl', 9 => 'v2', 'foo' => 'v3' ); 

foreach($tableau as Svaleur) { 

print "Element courant : $valeur\n"; 

} 

fo reach ($tabl eau as $cle => $valeur) { 

print "Element $cle du tableau : $valeur\n"; 

} 

reset(Stableau) ; 



while ( Sligne = each($tableau) ) { 
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print "Element $ligne[0] du tableau : $ligne[l]\n"; 

} 

reset(Stableau) ; 

while ( list($cle , Svaleur) = each (Stableau) ) { 
print "Element $cle du tableau : $valeur\n"; 

} 



L'instruction list() affecte directement plu- 
sieurs variables a partir d'un tableau (ici celui 
retourne par each()). 



Les tableaux superglobaux 

Jusqu'a present, nous avons traite des fonctionnalites propres a PHP, un peu 
a la maniere d'un langage autiste. En realite, PHP, langage concu pour le 
Web, est tout sauf replie sur ses propres capacites, d'abord parce qu'il dispose 
d'une pleiade d'extensions qui sont autant de fenetres sur l'exterieur, mais 
aussi et surtout parce qu'il propose un acces direct a toutes les informations 
echangees entre l'utilisateur (le plus souvent via son navigateur et un serveur 
web comme Apache) et l'interpreteur PHP. 

Pour cela, PHP propose des tableaux d'informations accessibles sous forme 
de variables predefinies. Le nom de ces variables commence le plus souvent 
par « _ ». 



Nom 


Contenu 


SCLOBALS 


Ce tableau contient I'ensemble des variables globale definies. II constitue une alternative a I'utilisation de l'instruction 
gl obal puisque les variables globales peuvent directement etre lues et ecrites a partir de ce tableau. 


$_C00KIE 


Ce tableau reunit I'ensemble des variables transmises par le navigateur du visiteur de la page PHP via les cookies. 


$_ENV 


L'interpreteur PHP est toujours execute dans un environnement donne, avec differentes variables systeme (les chemins, le 
nom de I'architecture). Ce tableau permet de lire ce jeu de variables et meme peut les modifier ou en creer de nouvelles. 


$_FILES 


Dans un formulaire HTML, il est possible de telecharger un fichier. L'ensemble des fichiers telecharges est decrit dans ce 
tableau. II est alors possible de savoir ou ceux-ci sont stockes ( pour les recopier par exemple dans un endroit propre a 
I'application). 


$_CET 


Toujours dans le cadre des formulaires HTML, $_CET contient la liste des variables transmises via la methode HTTPCET 
(c'est-a-dire sur I'URL). 


$_P0ST 


En complement, les variables transmises via la methode POST sont disponibles dans la variable $_P0ST. 


$_REQUEST 


Le tableau $_REQUEST agrege $_P0ST, $_CET, $_C00KIE en un seul tableau federateur. L'ensemble de ces valeurs a ete 
transmis a l'interpreteur via le reseau, depuis le navigateur de l'utilisateur. Par definition, il regroupe les variables dont le 
contenu pourrait etre nocif et qui doivent etre traitees avec precaution. 


$_SERVER 


Ce tableau permet de connaTtre le detail de la requete en cours (nom, parametres, chemin exact de la page demandee) et 
les elements plus specifiques au serveur web (nom, version) ainsi qu'a la connexion (IP distante, parametres du navigateur). 


$_SESSI0N 


Ce tableau permet de manipuler directement les donnees de session. II est decrit plus en detail dans le chapitre 5. 



COMPRENDRE Les variables predefinies 

Le manuel de PHP decrit de maniere approfondie 
les differentes variables evoquees ici. 
► http://www.php.net/manual/en/ 
reserved.variables.php 
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Toutes ces variables sont dites « superglobales », c'est-a-dire qu'elles sont 
visibles et disponibles a tout instant dans un programme PHP. II est done 
inutile de les declarer globales dans les fonctions, cette visibilite etant impli- 
cite. 

Des facilites exceptionnelles sur les 
chaines de caracteres 

Dans un langage comme PHP, a la fois non type et destine a construire du 
contenu, les operations sur les chaines de caracteres sont fondamentales. 
PHP dispose de multiples fonctions agissant sur les chaines (comparaison, 
remplacement, expressions regulieres, transformations en tableau) mais le 
langage permet aussi de proceder a des manipulations directement dans les 
chaines elles-memes. 

Pour delivrer le maximum de performances, PHP distingue les chaines stati- 
ques (entre apostrophes) des chaines qu'on pourrait qualifier de dynamiques 
(entre guillemets) et qui feront l'objet d'un traitement particulier. 

II est possible, la plupart du temps, de se contenter de chaines statiques, e'est 
le cas notamment pour le nom des fichiers a inclure ou pour certains mes- 
sages. 

Dans de nombreuses situations, la chaine attendue consiste cependant en 
une agglomeration de portions statiques, de valeurs stockees dans des varia- 
bles ou encore de caracteres speciaux. 

Vbus pouvez bien entendu creer une telle chaine en concatenant les diffe- 
rents elements (e'est le role de l'operateur « . »). 

$str = 'Ceci est une' . $superbe[$indexl] [$index2] . 'chaines de ' . 
Scaracteres . ' ! ' ; 

Nous agglomerons, dans notre exemple, outre des chaines statiques, un ele- 
ment de tableau, a savoir la valeur d'une variable. On imagine que cette 
notation peut devenir tres lourde si les chaines a creer sont quelque peu com- 
plexes. 

Avec les chaines dynamiques, PHP offre une alternative tres confortable. II 
devient effectivement possible d'integrer directement dans les chaines la 
valeur des variables PHP. 

$str = "Le nombre de col is est Sstock !"; 



Ici, le contenu de la variable Sstock sera substitue dans la chaine. Comme 
certaines situations peuvent etre difficiles a interpreter, PHP utilise aussi les 
accolades pour delimiter le nom de la variable ou l'expression a substituer. 

$nb = 3; 

$stock[$nb] = 12; 

// sans accolades, seules les substitutions simples vont etre reconnues 
print "Le nombre de colis de la semaine $nb est $stock[$nb] "; 
// avec les accolades il est possible de delimiter plus precisement la 
vari able 

print "Les donnees pour la semaine ${nb}[2004] sont disponibles"; 
$stock[$nb] ['lundi '] = 34; 

// voire de substituer des variables plus complexes (noter que 
1 'accolade ouvrante est placee avant le « $ ». 
print "Le nombre de colis regus le lundi de la semaine $nb est 
{$stock[$nb] ['lundi ']}"; 

Enfin ce type de chaines permet aussi d'inserer des caracteres speciaux 
comme la tabulation (« \t ») ou le retour chariot (« \n »). Notre exemple pre- 
cedent peut done s'ecrire : 

$str = "Ceci est une ${superbe[$indexl] [$index2]} chaine de Scaracteres 
!\n" 

Enfin, derniere possibilite, inspiree des shells Unix et surtout utile pour 
ecrire des chaines longues, l'utilisation de l'operateur « < < < ». La syntaxe est 
un peu particuliere : 

Svariable = «<FIN 
bla-bla, Sencore plus 
de 

bla-bla 
FIN; 

// suite de votre code PHP 

Les possibilites en termes de caracteres d'echappement et de remplacement 
sont identiques a celles disponibles pour les chaines entre guillemets. II faut 
noter que le mot qui delimite la fin du texte, dans notre exemple FIN, est 
libre et ne doit naturellement pas etre utilise dans la chaine. Par habitude, on 
utilise souvent EOF ou EOT (respectivement end of file et end of text). Enfin, ce 
delimiteur doit apparaitre seul, suivi d'une virgule sur la derniere ligne (pas 
d'espace ou d'autre caractere parasite). 



1 Methode de survie 

E 

i L'ensemble des elements precedents represents le strict minimum vital pour 

H demarrer l'exploration de PHP. A partir de la, tout est permis. La galaxie 

J PHP peut paraitre bien intimidante avec ses dizaines de milliers de fonc- 

$ tions, mais un peu d'habitude et de methode suffira non seulement a garder 

la tete hors de l'eau, mais a rapidement tirer profit de cet environnement 
tout en ameliorant sensiblement sa productivite avec PHP. 

Premier point, il faut savoir exploiter pleinement le manuel en ligne de PHP. 
C'est une habitude que Ton peut avoir perdu a force de subir les documenta- 
tions souvent aseptisees des logiciels proprietaires. Avec PHP, les termes de 
manuel et de documentation prennent, au contraire, tout leur sens. 
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LXIV. MySQL Functions 
Introduction 



1 



i 



These functions allow you to access MySQL database servers. More information about 
MySQL can be found at http: //www . mysql. com/ . 

Documentation for MySQL can be found at http://www, mysql. com/documentation/ . 

Requirements 

In order to have these functions available, you must compile PHP with MySQL support. 

Installation 

By using the with mysql [»i>ir] configuration option you enable pin? to access 
MySQL databases. 

In PHP 4, the option with mysql is enabled by default. To disable this default 
behavior, you may use the — wichout-mysql configure option. Also in PHP 4, if you 
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PHP: MySQL Functions - Manual - Moztta {Build ID: 2004031616) 
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MYbQL_AbSOC 



array index 



MYSQL_BOTH 



MYbQL_NUM 



columns are returned into the array having both a numerical index 
and the fieldname as the array index. 



Columns are returned into the array having a numerical index to the 
fields. This index starts with 0, the first field in the result. 



$ query ~ "SELECT * FROM my_tofolc"; 

Srcoult ~ royoql query ( Squcry) or die ("Query failed 

/* PtiiiLiiiy Lesulls iu HTML */ 
echo "<.table>\n"; 

while (Sline = mysql_f etch_array ( Sresult, M3tsUL_AS30C) ) { 
echo "\t<tr>\n" : 



myoql error ( J } ; 



Examples 

[his simple example shows how to connect, execute a query, pnnt resulting rows and 
disconnect trom a MySQL database. 

Example 1, MySQL extension overview example 

<?php 

/* Connectinq, selectxnq database */ 

Slink = mysql_connect ("raysql_host", "inysql_user", "mysq^password") 

or die ("Could not connect : " . mysql_error E ) ) ; 
echo "Connected successfully"; 

mysql splprrt: Hh("my rinhahftflp") nr Hip("CnulH nnt- splprtr Hatrahaap") ; 
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Sresult = mysql_query(" INSERT ..."J; 
if ( I Sresult) { 

Stx-> rollback (} ; 
) else { 

3 tx - >uux«iixL Q ; 

} 

mysql_dls connect ( $dbh) ; 
unset ($tx) ; 

The benefit of such a Transaction class is that it is generic and can wrap 
around any of your MySOJi statements . 

■■! 1 1— J-J 



19- Nov- 2001 03; 17 

ever wanted to know the date a table was last updated? use this : 

Sinfo = mysql_f etch_array («iysql_query ("show table status from databasename 

like 1 tablename ' "J J ; 

echo Sinfo["tTpdate_time M ] ; 



25-Sep-2001 08:11 

HI, here 1 s a nice little trick to select records in random order from a 
table in a MySQL database prior to version 3.23 

SELECT *, ( ItemlD/IterolD) *RAND ( ) A3 MyRandom FROM Items ORDER DY MyRandom 



[[[Editors note: 

And "lust SELECT * fKOM foo WHERE bar = KANUO alter 3.23 



—1 
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REFERENCE Oil trouver le manuel PHP ? 



Le site de reference est naturellement 
www.php.net, mais le miroir francais peut etre 
souvent plus veloce. Dans tous les cas, les com- 
mentaires des utilisateurs sont bien les memes. 
Pour les manuels en francais, la societe Nexen pro- 
pose une mine d'informations, dont les manuels de 
PHPet de MySQL. 

► http://ww.php.net/manual/en 

► http://fr.php.net/manual/en 

► http://www.nexen.net/docs/php/annotee/ 
manual. php 



Quelques adresses 



II existe une multitude de sites consacres a PHP, en 
voici quelques-uns parmi les plus connus : 

> http://www.phpfrance.com 

► http://www.hotscripts.com/ 

► http://www.phpindex.com/ 

Enfin, I'Association francaise des utilisateurs de 
PHP (AFUP) propose sur son site une liste de res- 
sources complementaires. 

> http://www.afup.org 



Tout PHP est dans ce manuel. C'est pourquoi, des maintenant, adoptez les 
reflexes des developpeurs PHP aguerris. Vbus avez un besoin particulier ? 
Allez directement dans le manuel, explorez les extensions et vous ne man- 
querez pas de detecter celle qui correspond a votre attente. Si vous decouvrez 
l'extension, lisez attentivement le resume general au lieu de plonger tete 
baissee dans le detail des fonctions. Le plus souvent, vous aurez un exemple 
type et une explication du role et du fonctionnement general de l'extension 
dans PHP. 

Naturellement, la suite logique consiste a se rendre sur la page de la fonction 
precise qui repond a vos besoins. La encore, outre le synopsis, vous trouverez 
le plus souvent plusieurs exemples cles. 

Vous pouvez naturellement telecharger le manuel PHP directement sur votre 
ordinateur. II est disponible dans de multiples formats, y compris sous forme 
de fichiers d'aide Microsoft Windows. Une traduction francaise est aussi dis- 
ponible, sans parler des versions integrees aux outils de developpement. 

Mais si telecharger le manuel permet d'acceder plus rapidement a une infor- 
mation precise, l'experience a montre que le manuel en ligne est un outil 
beaucoup plus precieux. En effet, au-dela de l'aspect documentaire, chaque 
page du manuel en ligne est completee par les commentaires des utilisateurs. 
Ce dernier point fait du manuel en ligne un outil fantastique pour com- 
prendre PHP. Que vous decouvriez PHP ou que vous soyez un expert en la 
matiere, il y a fort a parier qu'un autre utilisateur, et probablement meme un 
grand nombre, a partage vos incomprehensions et vos difficultes. Ainsi, ce 
sont des milliers d'utilisateurs a travers le monde qui, chaque jour, annotent 
ou completent le manuel PHP en ajoutant des eclaircissements et des exem- 
ples qui permettent de mieux beneficier de telle ou telle fonctionnalite. 

C'est pourquoi le manuel en ligne est irremplacable. II peut etre judicieux, 
dans cette optique, de ne pas limiter sa recherche au manuel PHP traduit en 
francais. Car meme si la communaute francophone des utilisateurs de PHP 
est tres importante, le nombre de contributions est encore plus important 
pour le manuel anglais. Et n'ayez crainte, l'anglais des informaticiens n'est 
pas bien difficile a comprendre, probablement d'ailleurs au grand dam des 
vrais anglophones et des linguistes ! 

Avec le manuel, vous avez done immediatement acces a l'information de 
reference ainsi qu'aux exemples additionnels des utilisateurs. Si tout cela se 
revele insuffisant, les forums et les bibliotheques de scripts peuvent vous 
apporter des reponses encore plus concretes. 

Pour finir, Google et les moteurs de recherche en general sont vos amis ; 
quelques mots-cles et vous pourrez explorer une liste encore plus importante 
de ressources PHP. Au fil du temps, vous avez la un bon moyen pour vous 
constituer un annuaire de sites, a votre convenance. 
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En resume 



La syntaxe de PHP est un melange coherent des syntaxes les plus connues et 
les plus usitees. Elle ne recele aucune originalite, ce qui explique sans doute 
l'extreme facilite a prendre en main ce langage. Debuter avec PHP est done 
un jeu d'enfant. Apres cette phase initiale, PHP n'est pas plus complexe pour 
autant. II suffit de garder toujours a l'esprit que, passe l'apprentissage de la 
syntaxe, la puissance de PHP ne se revele que dans sa fantastique biblio- 
theque d' extensions. 

En fonction de vos besoins, la bonne technique consiste done a explorer les 
extensions disponibles pour choisir la plus adaptee. Le manuel en ligne de 
PHP se revele alors l'outil indispensable pour decouvrir le detail des fonc- 
tionnalites et les commentaires des utilisateurs sur toutes les subtilites qui 
pourraient avoir echappe au manuel. 



[/application web exemplaire 

en PHP 5 



Notre etude de cas, une application de discussion en 
ligne, est choisie simple mais riche. 

Elle illustre en quoi PHP, et en particulier PHP 5 
avec son implementation objet, est adapte aux besoins 
des applications et sites Internet. 
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PHP Saloon, un chat en PHP 



Et en PHP4 ? 

Nous aurions pu developper PHP Saloon en utili- 
sant les seules possibilities de PHP 4. C'etait une 
alternative. Cependant, nous le verrons tout au 
long de cet ouvrage, un site Internet dynamique 
requiert du temps et de I'energie. C'est une raison 
plus que suffisante pour ne pas se priver des ame- 
liorations considerables apportees par PHP 5. 



PHP et a fortiori PHP 5 sont d'une grande richesse fonctionnelle. Tous les 
exemples de ce livre reposent sur une etude de cas simple, qui nous servira de 
fil conducteur. II s'agit d'un service de dialogue entre connectes, c'est-a-dire 
un chat, pour utiliser le terme du moment. Nous avons baptise ce service : 
PHP Saloon. 

PHP Saloon represente le prototype meme du site dynamique. Cette veri- 
table application web met en scene les elements classiques attendus pour 
tout service professionnel : 

• creation de sessions personnalisees ; 

• acces a des services reserves ; 

• delivrance d'informations ; 

• parcours d'un catalogue. 

Ce sont la des elements qu'on pourrait tout a fait retrouver sur un site mar- 
chand. 

PHP Saloon en detail 

PHP Saloon est done une application de chat en ligne qui cree une sorte de 
point de rencontre, de lieu d'echange virtuel sur Internet. Ces applications 
sont tres en vogue et la plupart des fournisseurs de messagerie comme 
Yahoo! ou MSN ont elargi leur offre a ce type de communautes virtuelles. 

Le systeme nest pas tres eloigne des solutions de messagerie instantanee. 
Cependant, dans la pratique, la messagerie instantanee est plutot utilisee 
entre cercles d'amis deja constitues. Le chat au contraire propose plutot une 
approche de type melting pot ou les contacts s'etablissent entre des per- 
sonnes qui ne se connaissent pas forcement. PHP Saloon propose un 
melange des deux mondes en permettant a la fois de discuter avec ses amis et 
d'entrer facilement en contact avec les autres visiteurs connectes. 

Chaque visiteur s'identifie a son arrivee, ce qui lui permet d'apparaitre dans 
l'annuaire des personnes connectees. Grace a cet annuaire, les differents uti- 
lisateurs vont pouvoir se contacter et echanger des messages. Naturellement, 
chaque habitue du systeme peut creer son annuaire personnel pour refe- 
rencer ses amis et ne pas avoir a les chercher dans la liste lors de ses visites 
successives. 

Cette premiere description, a laquelle adhere la quasi-totalite des systemes 
de chat, permet d'ores et deja de se faire une idee de l'architecture que pour- 
rait avoir PHP Saloon. 

Pour le moment, nous allons identifier les differents elements mis en jeu, 
preciser notre vision de l'application et composer ainsi un cahier des charges. 
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Une inscription prealable 

Tout systeme de chat, et plus generalement d'echanges entre connectes, 
repose sur la notion d'annuaire. Contrairement a la visite d'un site web clas- 
sique, il est necessaire de s'inscrire avant d'utiliser le service. 



& Find/Add Contacts 




Nick 



dupont 

Dupont 

DUPONT 

dupont 

Dupont 

Dupont 
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Dupont 
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dupont 
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Qrr, 

$MJ. • •• 

:Qm - - 
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More options 



Idle 



\20 ICQ users found 



Figure 1-1 Exemple de messagerie instantanee avec annuaire des utilisateurs 



Lors de la premiere visite, l'inscription va permettre au visiteur de se consti- 
tuer un portrait. Celui-ci permettra aux autres connectes de se faire une idee 
du visiteur avant de le contacter eventuellement. 

Chaque chat est libre de definir les elements du portrait. Pour PHP Saloon 
nous allons adopter les elements les plus classiques : 

• nom de code ; 

• age; 

• sexe ; 

• pays; 

• ville ; 

• emoticone. 

Une identification a chaque visite 

Une fois inscrit, le visiteur devra s'identifier lors de chaque visite. II precisera 
son nom de code et le mot de passe qu'il a choisi. Ceci fera apparaitre son 
portrait dans l'annuaire, en le rendant visible aux yeux des autres connectes. 





Figure 1-2 Inscription et identification 
dans PHP Saloon 
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Mom de code : 
| cactus 

Mot de passe : 



Message du jour : 
Cactus grognon, 
attention. 




Figure 1-3 Maquette de la page d'identification de PHP Saloon 

Un tableau de bord en trois morceaux 

Une fois connecte, le visiteur doit pouvoir acceder a trois groupes de 
fonctions : 

• parcours de l'annuaire des connectes ; 

• parcours de la liste des amis ; 

• lecture et ecriture des messages. 

Ces trois fonctions pourront etre accessibles sur une meme page, si le client est 
un navigateur traditionnel (la figure 1-4 propose un croquis d'une presentation 
possible), ou presentees separement, par exemple sur un telephone mobile. 



Figure 1-4 

Exemple de tableau 
bord pour PHP Saloon 




Pourquoi choisir PHP 5 ? 

La conception de notre application logicielle doit tenir compte de possibles 
evolutions futures, chose quasiment inevitable dans le domaine du logiciel. II 
faut tenir compte des contraintes de maintenance, d'evolution et d'exploita- 
tion. 

Dans une application professionnelle qu'on gerera au quotidien, il est alors m j.- L Benard et a/., L'Extreme Programming, 
essentiel d'optimiser l'entretien au long cours - un cout considerable, meme Eyrolles 2002. 

pour un site personnel ! 



RAPPEL Repartition de I'effort dans un projet informatique 

Pourquoi tant d'attention port.ee a la maintenance et I'exploitation de notre application ? 
Tout simplement parce qu'il s'agit de la phase la plus couteuse dans la vie d'un logiciel. 
Les statistiques ci-dessous presentent la repartition du temps passe sur la vie du logiciel et 
plus precisement sur la phase de developpement. Elles reprennent des valeurs classique- 
ment admises dans I'industrie du logiciel, mais ne nous leurrons pas, cet etat de fait s'appli- 
que aussi a votre site web personnel... Qui n'a pas passe des soirees entieres a modifier 
son site, a en changer un detail ou finalement a en refaire des pans entiers. . . 
Ce qui, pour un site personnel, peut emousser I'attrait du Web et decourager en laissant la 
technique prendre le pas sur la motivation de depart a naturellement un impact plus impor- 
tant en entreprise, mais le fond du probleme reste identique. 




Figure 1-5 Repartition du temps entre la 
phase de creation et celle de maintenance 




Figure 1-6 Repartition du temps passe 
lors du developpement d'un logiciel 
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PHP 4 



Dans cette optique, PHP, qui n'a pas encore 10 ans, parait bien jeune et 
souffre de nombreuses lacunes. Ces lacunes empechent les developpements 
et limitent la possibility de creer des applications extensibles et faciles a 
maintenir. 

Aller vers un modele a composants 

Si PHP 4 permet en apparence de creer des objets, il n'en connait en realite 
pas vraiment la notion, et se contente de voir ces objets comme des tableaux 
associatifs banals. Cette vision des choses revient a evacuer la plupart des 
proprietes du modele objet, pour ne retenir finalement que la notion 
d'agregat d'informations (attributs ou methodes). A ceci, il faut ajouter la 
contre-performance liee aux operations de copie de ces tableaux. 

Ainsi, faute de modele objet efficace, un tres grand nombre d'applications 
PHP ont fait l'impasse sur ce concept. Est-ce un drame ? Non bien sur, mais 
loin de vouloir faire de l'objet pour de l'objet, ce modele, complete par une 
prise en compte des composants, nous aurait permis de realiser une implan- 
tation beaucoup plus modulaire et reutilisable dans d'autres applications, et 
facile a entretenir sur la duree. 



COMPRENDRE L'histoire a grande vitesse de PHP 

PHP est un jeune langage. II tire son origine d'un langage moins evolue : PHP/FI cree en 
1995 par Rasmus Lerdorf. Comme dans beaucoup de cas, Rasmus a d'abord developpe 
PHP/FI pour son usage personnel (d'ou le nom : Personal Home Page, Form Interpreter) sous 
la forme d'une bibliotheque de fonctions Perl, puis d'une veritable implantation en C. En 
1997, pour sa version 2, PHP/FI connait un succes d'estime non negligeable, mais reste un 
projet personnel. 

Au meme moment, ce sont deux utilisateurs de PHP/FI, Zeev Suraski et Andi Gutmans qui, 
mecontents des performances, vont reecrire PHP/FI et ainsi donner naissance a PHP 3.0, la 
premiere version veritable du langage tel que nous le connaissons. Ceci sonnera le glas de 
PHP/FI qui laissera place a son successeur PHP (dont le sigle est desormais synonyme de 
« PHP : Hypertext Processeur »). 

Robuste, et dote de capacites d'extensions, PHP 3.0, officiellement publie en juin 1998, 
aura conquis en un an plus de 10% des serveurs web du monde. 
Ce laps de temps a permis aux deux createurs de repenser le coeur de I'interpreteur PHP et 
de creer I'entreprise Zend (une contraction de Zeev et Andy) et son developpement Open 
Source phare : le Zend Engine. Ce moteur ameliore animera PHP 4.0, officiellement 
annonce en 2000, nouvelle version plus performante de PHP, integrant encore plus d'exten- 
sions et le support de plusieurs serveurs web. 

L'histoire ne s'est pas arretee la, et I'arrivee du Zend Engine 2 permet a PHP dans sa 
version 5 de continuer plus avant sur le chemin des performances et de I'enrichissement 
fonctionnel, et surtout d'entrer de plain-pied dans I'univers des langages objet. 

► http://www.php.net/manual/fr/history.php 

► http://www.zend.com/ 



Ameliorer la gestion des erreurs 

Autre faille de notre application actuelle : la gestion des erreurs. En effet, 
PHP 4 ne propose pas de mecanisme particulier en la matiere. Les erreurs 
sont detectees et reportees en utilisant des codes de retours. 

Un tel systeme devient tres vite cauchemardesque et, au final, pour ne pas 
compliquer inutilement le code par des tests incessants, on en arrive toujours 
a ignorer ca et la telle ou telle possibilite d'echec. 

Les echecs ne manqueront pas de survenir lors de l'utilisation de Implica- 
tion, et faute d'un traitement approprie, ils laisseront le visiteur bien per- 
plexe devant une page illisible ou s'enchevetrent contenu et messages 
d'erreurs PHP. 

Ameliorer le support XSL 

Dernier element, l'utilisation d'XML et le rendu a base de transformations 
XSL complexes a utiliser pour des performances par ailleurs tres moyennes... 
Pourtant ce procede permet de separer le traitement de l'information de son 
rendu pour differents medias (navigateur, telephone) et ameliore sensible- 
ment la lisibilite du code developpe. 

On peut naturellement laisser au navigateur le soin de realiser la transforma- 
tion XSL. C'est une simplification importante qui evite les affres de la trans- 
formation avec PHP 4 mais il s'agit surtout d'une limitation considerable. 
Seuls Mozilla et Internet Explorer 6 sont en mesure de realiser de telles trans- 
formations. 

On perd done l'interet de ces transformations qui permettent en theorie de 
produire simplement des versions du site pour plusieurs medias (navigateur, 
assistant personnel ou telephone mobile par exemple). 

Adopter PHP 5 pour conserver PHP 

Lensemble des limitations qui viennent d'etre evoquees pourrait nous 
amener a nous interroger sur notre choix. PHP est-il finalement le plus 
adapte ? Ce serait oublier un peu vite les qualites intrinseques du langage, 
qualites desormais dopees par les ameliorations de la version 5. Et quelles 
ameliorations ! 

PHP, un environnement simple 

Parmi les raisons le plus souvent avancees pour justifier l'abandon d'une 
application, ou de son propre site personnel, l'exploitation quotidienne est 
certainement la plus importante. Dans cette optique, une des erreurs cou- 
rantes consiste a deployer des outils qu'on ne saura pas maitriser. 



B.A.-BA Le principe KISS 

KISS signifie en anglais : keep it simple, stupid. II 
s'agit d'une devise initialement adressee aux deve- 
loppeurs et qui constitue un veritable eloge de la 
simplicite. Ce principe, parmi les plus connus du 
monde Unix et Internet, consiste a toujours recher- 
cher la simplicite meme si cela conduit a ignorer, 
parfois temporairement, des innovations. Ce prin- 
cipe a guide la definition des protocoles web et 
Internet qui, a defaut d'etre revolutionnaires, sont 
simples a mettre en oeuvre et plus economiques 
que des concurrents a priori plus sophistiques ou 
plus evolues. PHP illustre parfaitement ce 
principe : rien d'exceptionnel ni complique, juste 
un langage fonctionnel qui fournit le resultat 
attendu. 
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CULTURE Blog&Wiki 

Un blog (raccourci de WebLog) est une sorte de 
journal personnel publie sur le Web. C'est une 
reponse technique simple apportee a un besoin 
d'expression. Nulle question, dans un blog, 
d'HTML, balises ou autres. Chaque auteur peut 
publier jour apres jour ses billets. Naturellement, 
leur contenu varie du carnet intime au journal the- 
matique, en fonction de I'auteur. 
Quant au Wiki, il offre la possibility de creer du 
contenu issu de la collaboration de plusieurs 
auteurs. Chacun est libre d'enrichir les pages du 
site - ce qui a permis la naissance de plusieurs 
projets d'encyclopedies sous forme de wikis. Tout 
un chacun peut le completer en fonction de ses 
connaissances et de ses decouvertes. 
La encore, on mise sur la simplicite : quelques rac- 
courcis typographiques et surtout pas de HTML. 
Dans les deux cas, ce sont des solutions simples, 
techniquement parlant, qui sont plebiscites et 
repondent aux souhaits des utilisateurs. Plusieurs 
implantations existent en PHP. 



Tout le monde peut en etre victime ; jour apres jour, on tente de nous 
demontrer a force de publicite et d'arguments imparables le caractere indis- 
pensable de solutions toutes plus merveilleuses les unes que les autres. II faut 
savoir resister. 

Une des qualites essentielles de PHP est sa simplicite de mise en oeuvre. Ce 
n'est pas un hasard si PHP est le langage retenu en priorite par les heber- 
geurs. II offre tout simplement une solution robuste et fiable. 

Dans un autre domaine, le succes grandissant des blogs et des wikis montre 
lui aussi que la reponse a un besoin donne ne passe pas necessairement par 
des solutions complexes. 

C'est pourquoi, independamment des manques reels dans PHP, y compris 
dans la version 5 a laquelle cet ouvrage est consacre, PHP est, dans une large 
majorite de cas, la solution la plus economique et la plus simple a maitriser 
pour mettre en oeuvre une application ou un service web. 

Aussi, avant de choisir l'environnement qui motorisera votre application, 
posez-vous d'emblee les bonnes questions : saurai-je maintenir l'outil jour 
apres jour ? Ai-je les moyens de deleguer a des tiers ? S'il s'agit d'un site per- 
sonnel, avez-vous l'envie, le temps pour entretenir une solution complexe ? 

REGARD DUDEVELOPPEUR PHP 5, regrets et espoirs 

La nouvelle mouture de PHP 5 apporte une couleur professionnelle a PHP, cela represents 
deja un effort de developpement important pris en charge par les concepteurs et deve- 
loppeurs de PHP. Naturellement, chacun voudrait voir sa fonctionnalite presente. Mais il 
faut a un moment donne savoir fixer le perimetre des fonctionnalites qui seront integrees 
dans une version. Cela impose des choix, et forcement on peut toujours avoir certains 
regrets. 

Au chapitre regret justement, on pourra evoquer les namespaces qui apres quelques tests 
ne seront pas integres a PHP 5. 

Les namespaces peuvent etre decrits grossierement comme des containers, lis permettent 
d'englober tout le code d'un module. Les elements du module sont alors accessibles en pre- 
fixant leur nom par celui du container (par exemple : mysqT : : connect en utilisant la nota- 
tion : : classique dans le monde objet). Les risques de conflits entres modules sont done 
elimines. 

Comme nous pouvons le constater, les namespaces pourraient etre un outil fantastique 
pour doper la creation de composants reutilisables en PHP, ceci independamment du 
modele objet. 

Toujours au chapitre composant, faute de namespaces peut-etre, PHP ne permet pas 
d'importer facilement les composants et a fortiori une hierarchie de composants, comme le 
permet par exemple Java avec I'instruction import. II faut soi-meme, a la main si Ton peut 
dire, inclure les differents fichiers. 

Par ailleurs, PHP ne permet pas d'inclure des fichiers deja compiles pour I'interpreteur PHP 
ou mieux, des archives de fichiers compiles (naturellement le parallele Java est le JAR). 
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Un langage glu 

De nombreuses interrogations persistent au niveau du langage meme. Mais 
si PHP n'est ni Java, ni C++ ni Python, vous restez en mesure de le maitriser, 
et sinon, de nombreux collegues de l'entreprise seront a meme de le faire. 

PHP correspond ainsi tres exactement a la definition d'un langage glu. C'est 
a notre sens l'une des raisons essentielles de son succes, comme cela rut le cas 
pour Visual Basic. II met a la portee de tous la realisation d'applications sur 
mesure. 

Naturellement, l'ecriture des extensions proposees par PHP reste l'affaire de 
specialistes, mais PHP va nous permettre d'en tirer profit. 



B.A.-BA Qu'est-ce qu'un langage glu ? L'exemple de Tel 

John Ousterhout, createur du langage Tel, a illustre une des qualites essentielles que parta- 
gent autant Tel que PHP ou encore Visual Basic, en utilisant le terme de langage glu. Un 
langage glu est un langage simple a apprendre et a utiliser, qui va servir de socle (de 
ciment) pour creer des applications personnalisees en combinant des composants techni- 
ques, souvent complexes, ecrits dans d'autres langages, en general mieux adaptes aux 
ingenieurs et informaticiens chevronnes. 

Rappelons qu'une definition rapide de Tel pourrait etre : le PHP de I'ere pre-lnternet. Tel est 
un langage interprets simple, qui comme PHP dispose d'une bibliotheque impressionnante 
d'extensions. Dans le cas de Tel, le client est un client lourd avec une interface construite en 
Tk (une bibliotheque graphique, qui dans notre analogie avec PHP, va jouer le role d'HTML). 
Tel a ainsi ete tres largement utilise pour creer des applications client/serveur graphiques 
en un tour de main, en particulier utilisees par les administrateurs reseau. 
Tel est encore largement utilise aujourd'hui, ainsi un des outils d'administration de Pos- 
tgreSQL, PgAccess, est developpe en Tcl/Tk. PgAccess est ainsi disponible sur de multiples 
plates-formes, PC et Mac compris. 
► http://www.tcl.tk/ 



Le modele objet complet de PHP 5 

PHP 5 tente de combler les lacunes encore presentes dans PHP 4 en inte- 
grant un nouvel interpreteur : la version 2 du moteur Zend (le fameux Zend 
Engine). 

Ce nouvel interpreteur est plus rapide comme on pouvait s'y attendre et sur- 
tout, il renove completement le support des objets. 

Desormais, PHP va reellement disposer d'un type objet jusqu'au coeur du 
moteur. S'il est traite de maniere specifique, c'est pour eviter les recopies de 
donnees inutiles en memoire lors de la manipulation d'objets (les specialistes 
reconnaitront la l'usage des references) et pour integrer les fonctionnalites 
cles du modele objet jusqu'a present absentes : gestion des constructeurs et 
destructeurs, champs prives et statiques... 



EN COULISSE Rouages internes de PHP : le Zend Engine 

Pour comprendre I'importance du Zend Engine, il est 
necessaire d'avoir une idee du fonctionnement de PHP. 
Celui-ci est le plus souvent utilise en collaboration avec 
un serveur web, mais peut aussi etre utilise seul. C'est 
pourquoi depuis sa version 4, PHP dispose d'une inter- 
face (SAPI) qui normalise les echanges entre PHP et le 
programme qui integre PHP (Apache, IIS ou un logiciel 
tiers). 

Dans le cas ci-apres, lorsque le serveur web recoit une 
requete Q (la demande d'une page par exemple), il 
transmet le code de la page demandee a PHP en utili- 
sant I'interface SAPI. Ce code est dirige vers le compila- 
teur a la volee (JIT : Just In Time) du Zend Engine 
Celui-ci va analyser le code, en verifier la syntaxe et pro- 
duire un equivalent code (on parle de code objet) beau- 
coup plus rapide a manipuler. Ce code est transmis a 
I'interpreteur du Zend Engine Q. Le moteur va derouler 
le code code et ainsi produire le code (probablement 
HTML) resultat de I'execution de notre page PHP. 



Naturellement, si I'interpreteur sait executer le cceur 
du langage (boucle, traitements des variables), il va 
deleguer aux extensions de PHP le traitement des ins- 
tructions qui les concernent Q, P ar exemple I'acces a 
une base de donnees, ou la creation d'une image. 
Une fois I'execution du code terminee, le resultat pro- 
duit est renvoye au serveur web via I'interface SAPI 
©... le serveur web renvoyant lui-meme le resultat au 
navigateur 0. 

Cet exemple tres simple montre le role de chef 
d'orchestre du Zend Engine qui seul sait traiter le code 
PHP et faire appel aux extensions disponibles. La defi- 
nition d'extensions est alors un jeu d'enfant puisqu'il 
suffit de consciencieusement respecter I'API prevu par 
le Zend Engine. Cette parfaite organisation explique 
tres largement la multitude d'extensions presentes 
dans la distribution PHP. 



Figure 1-7 

Architecture interne de PHP 
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Un nouvel ensemble de types predefinis 

Suite logique de ce nouveau potentiel, PHP integre desormais une extension 
regroupant tout un ensemble de classes modelisant des structures de donnees 
classiquement utilisees dans les algorithmes. II s'agit par exemple des piles, 
des files d'attentes, des ensembles ou encore des arbres. On park de types 
abstraits de donnees (en anglais Abstract Data Types ou ADT) pour desi- 
gner ces structures. 

La oil le developpeur devait reinventer la roue, comme d'ailleurs les auteurs 
de Pear ont du le faire de leur cote, PHP propose un socle commun. Une 
base partagee qui devrait : 

• simplifier le code developpe, en evitant a tous de redevelopper des outils 
inclus et maintenus dans PHP ; 

• mettre a disposition via ce socle commun un code de meilleure qualite. 

En effet, plus un code est utilise, plus on dispose de retours. Ces retours 
d'experience permettent de resoudre les defauts et sont inaccessibles a une 
telle echelle au developpeur isole (meme pour les applications d'entreprise). 

Refonte du support XML/XSL 

Enfin, PHP tire profit de la maturite des bibliotheques XML et XSL utili- 
sees par le projet Gnome qui deviennent dans PHP 5 le moteur de reference 
utilise pour traiter les fichiers XML. 

Une decision qui devrait : 

• ameliorer les performances ; 

• clarifier le fonctionnement de ces extensions. 

Ecrites en C, les bibliotheques choisies sont en effet sensiblement plus 
rapides que les diverses implantations disponibles par ailleurs. 

Enfin, et c'est probablement le plus important apres l'integration d'un pre- 
mier outil (Sablot), puis la modification des interfaces XSL, la perennite 
semble enfin au rendez-vous. Un point essentiel si Ton souhaite voir l'usage 
d'XML et des transformations XSL largement adopte. 



COMPRENDRE Demystifier XML/XSL 

Demystifions tout de suite XML/XSL. Le manque de maturite des outils a pu faire croire que 
les langages en eux-memes, notamment pour XSL, etaient inaccessibles au commun des 
developpeurs. II n'en est rien. II convient juste de bien apprehender leur logique et de ne 
pas I'oublier en cours de route. Nous verrons au chapitre 7 comment utiliser ces langages, 
dont il est difficile de faire I'impasse aujourd'hui pour des applications interoperables et 
reutilisables. 



B.A.-BA Pear (PHP Extension 
and Application Repository) 

Pear est une bibliotheque de code Open Source 
pour PHP. Cette bibliotheque est organisee de la 
maniere la plus rigoureuse possible. 
Le code integre doit respecter un guide de style 
specifique et est ensuite classifie rigoureusement 
dans la bibliotheque. 

Pour faciliter le travail des developpeurs, Pear pro- 
pose par ailleurs une serie d'outils utiles lors des 
phases d'installation ou de maintenance. 
Le developpeur PHP a toujours interet a jeter un 
ceil du cote de Pear avant de reinventer la roue, 
meme s'il est vrai que le projet Pear, plus recent 
que PHP, n'a pas le meme niveau de maturite et 
qu'il convient de s'assurer du niveau de stabilite 
des modules convoites. 
► http://pear.php.net 



B.A.-BA Gnome 

Gnome est un environnement de travail graphique 
complet pour les utilisateurs. II est largement uti- 
lise sous GNU/Linux et sous differents systemes 
Unix, et une large partie de ses logiciels est aussi 
disponible sous Windows, notamment Gimp. 

► http://www.gnome.org 

► http://www.gimp.org 
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Facilite d'emploi 



Facilite d'emploi 
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Maintenabilite 



Perl Maintenabilite 



PHP 5 



Figure 1-8 Ratios puissance, complexity et facilite d'emploi des solutions web les plus utilisees 



En resume 



Dans ce chapitre, nous avons conforte PHP, et naturellement PHP 5, en 
tant que langage de developpement ideal pour notre type de projet. Ce choix 
est autant redevable de la simplicite du langage que de sa richesse fonction- 
nelle. 

Nous avons de meme defini precisement notre etude de cas, un point capital 
qui va maintenant nous permettre de tirer pleinement profit des nouvelles 
possibilites de PHP 5 et du modele objet. 

A RETENI PHP n'est-il pas devenu trop complexe ? 

Nouveau modele objet, fonctionnalites revues et corrigees, design patterns, PHP 5 ne perd- 
il pas I'essence meme de ce qui a fait le succes du langage ? II est vrai que I'avalanche de 
nouveautes peut effrayer, mais ne nous y trompons pas, le noyau dur du langage demeure 
inchange. Libre a vous de n'utiliser que les fonctionnalites qui vous interessent avec, encore 
et toujours, ce langage simple et efficace qu'est PHP. 

A ce sujet, une comparaison rapide (et assez grossiere) des differents langages adoptes 
pour le developpement des applications web montre que si PHP, dans cette nouvelle mou- 
ture, offre des outils qui le rapprochent de ses concurrents les plus sophistiques, il reste un 
langage tres simple d'emploi et depassant largement les solutions fondees sur Java qui 
necessitent une reelle expertise des frameworks mis en ceuvre (J2EE, BEA WebLogic...). 
Une aptitude qui n'entrave pas pour autant PHP (a fortiori PHP 5) dont la puissance et les 
performances ont d'ores et deja conquis les plus grands sites mondiaux comme le demon- 
trent les retours d'experience presentes sur le site de I'AFUP (Association francaise des uti- 
lisateurs de PHP). 
► http://www.afup.org/ 



chapitre 




Modele 



Messages 
Connectes 



Amis 
Sess on 



Nouvelle session 



Variables serveur 



Document XML 



Controleur 



Nouvel Ami 



Nouveau message 



Patron XSL 



Vue 



Document final 



Nouvel utilisateur 



PHP Saloon 



Organisation et decoupage 
du travail avec les interfaces 



Avant d'ecrire le code d'une application, il est sage 
de proceder a un decoupage en sous-briques, plus 
simples a realiser. C'est ce que nous allons faire pour 
PHP Saloon. 

Le resultat de cette analyse sera realise avec d'autant 
plus de facilite que PHP 5 permet desormais de definir 
les interfaces de nos modules. 
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Premiers elements de ['architecture 
logicielle 



METHODE Deux approches : 
bottom-up et top-down 

Pour decrire une application, on peut proceder 
de deux manieres. 

La premiere est de definir les differents compo- 
sants elementaires, puis de les agreger progres- 
sivement les uns aux autres pour finalement 
aboutir a I'application finale. C'est I'approche 
bottom-up (du particulier au general). 
La seconde, a I'inverse, consiste a d'abord consi- 
derer I'application dans son ensemble puis a la 
decomposer en modules de premier niveau, en 
redecoupant a nouveau pour arriver aux compo- 
sants elementaires. C'est I'approche top-down 
(du general au particulier). 
Chaque approche a ses avantages et ses incon- 
venients, I'approche top-down offre une vision 
plus synthetique des developpements, I'appro- 
che bottom-up permet de definir plus facilement 
des bibliotheques de composants reutilisables. 



ALTERNATIVES Autres types 
d'architectures : .NET et JSF 

L'architecture MVC est retenue par nombre de pro- 
jets, c'est notamment le cas de Jakarta Struts qui 
met en ceuvre MVC sur une plate-forme Java. 
Cependant les alternatives existent, on peut 
notamment adopter un modele evenementiel, pro- 
che du modele client/serveur. C'est le choix fait par 
.Net, I'environnement de Microsoft, mais aussi par 
les JSF (Java Server Faces), recemment propose par 
le pere de Java, Sun Microsystems. 



Les croquis rapidement realises du chapitre precedent donnent une idee du 
resultat souhaite pour PHP Saloon, mais il faut maintenant regarder sous 
cette apparence, et organiser le developpement. 

Pour nous simplifier la tache, nous allons, en suivant une sorte d'approche 
« top-down », decouper de plus en plus finement notre application et les ele- 
ments qui la composent. Au final, il nous restera des modules simples a 
coder (qui par ailleurs serviront chacun a illustrer les nouvelles capacites de 
PHP 5). 

Nous n' allons pas realiser le decoupage de PHP Saloon au hasard mais en 
nous inspirant d'un modele d'architecture : l'architecture MVC ou Modele, 
Vue, Controleur. Cette architecture est tres repandue et est notamment tres 
en vogue dans le monde Java. 

Ce type de decoupage etait jusqu'a present assez delicat a realiser en PHP. 
D'une part, le code PHP se trouve en general au beau milieu du code 
HTML, il n'est plus question alors de distinguer vue et controleur. D'autre 
part, la faiblesse du modele objet disponible jusqu'a present ne permettait 
pas vraiment de decrire les differents aspects, modele, vue ou controleur. 

En choisissant PHP 5 et XML comme noyau technologique pour PHP 
Saloon, nous adoptons au contraire les outils qui vont nous permettre de 
correctement organiser notre application : 

• En utilisant XML (et les transformations XSL), nous allons separer de 
fait le rendu (la vue) des differents traitements qui produisent le code 
XML (le controleur). 

• Enfin, le modele objet complet, disponible dans PHP, va nous permettre 
de specifier les interfaces des modules qui composent PHP Saloon et 
ainsi d'identifier precisement les composants qui relevent du modele ou 
du controleur. 



METHODE L'architecture MVC (modele-vue-contrdleur) 

Le modele MVC est I'un des modeles de conception les plus repandus. II consiste a separer 
une application en trois composants distincts de maniere a en faciliter la conception et la 
realisation. 

Le composant model e decrit I'ensemble des donnees qui sont manipulees par I'application. 
II peut s'agir d'objets ou d'elements de base de donnees. 

Le composant vue definit les mecanismes qui vont permettre de prendre en compte les 
actions de I'utilisateur et de representer les donnees. 

Enfin, le composant controleur gere la logique metier de I'application, I'ensemble des 
traitements sur les donnees. II constitue une sorte d'interface entre la vue et le modele. 
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Les flux d'information dans PHP Saloon 



Pour definir precisement l'interface de nos trois composants de premier 
niveau, identifions les flux d'information qui circulent au sein de l'applica- 
tion. Pour la vue, les choses sont tres simples. A partir d'un document XML 
et d'un patron XSL, la vue genere une sortie. Dans le cas general il s'agit de 
HTML, mais nous traiterons aussi le cas de formats comme le cHTML 
pour telephones i-mode ou Wap. 

Patron de 

transformation XSL 



V 



Document XML 


Vue 


Document final 
pour le navigateur 


► 





Figure 2-1 Flux d'information pour la vue 



RAPPEL SADT (Structured Analysis and Design Technique) 

SADT est une methode tres graphique dans sa presentation, les pro- 
cessus y sont decrits sous forme de rectangles et de fleches : les rec- 
tangles vont representor les actions, comme afficher une carte, stac- 
ker les informations client; les fleches vont materialiser les flux 
d'information tels le nom du client, la position d'un aerodrome, etc. 
On respecte en general les conventions suivantes : a gauche, les 
« input » ou matieres premieres, a droite les « output » ou produits 
finis. En haut, les elements de controle du systeme. Les diagrammes 
ainsi obtenus portent le nom d'actigrammes (en reference aux activi- 
tes que represented les boTtes). 



Controle 




Matieres premieres 



Produit transform^ 
► 



Enfin, on part d'une vue d'ensemble, comportant quelques actions, 
pour aboutir a plusieurs decompositions en sous-systemes, un peu a 
la maniere des poupees russes. 

La methode SADT ne se limite naturellement pas a ces quelques ele- 
ments graphiques et s'attache a decrire I'integralite des flux manipu- 
les, qu'il s'agisse des traitements, comme dans le cas de nos acti- 
grammes, ou des donnees. Enfin, SADT definit un cycle complet entre 
auteurs et relecteurs. Un processus qui prend tout son interet dans la 
relation client/prestataire. 



ft faible niveau de detail ft 




■0- niveau de detail eleve -0- 



Le controleur, de son cote, est le producteur du document XML qui est 
transforme par la vue. C'est un peu le cceur de PHP Saloon. Les echanges 
entre ce noyau central et le modele sont done naturellement plus complexes. 
En reconsiderant les croquis du chapitre 1, on peut cependant identifier dif- 
ferents flux : 

• les echanges lies a l'identification et au controle de la session utilisateur ; 

• la manipulation de la liste des abonnes ; 

• la gestion de la liste des amis ; 

• la manipulation des messages. 

L'ensemble de ces flux d'information sont a destination ou a l'origine du 
modele. 
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Figure 2-2 Flux d'information pour le controleur 

L'identification des flux du modele est elementaire. Cela concerne exclusive- 
ment les echanges avec le controleur. 
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Figure 2-3 Flux d'information pour le modele 



En regroupant ces differents elements, nous obtenons le datagramme 
SADT suivant qui va nous servir de reference pour definir nos interfaces. 



Modele 



Messages 
Connsctes 



Amis 



Sess 



on 



Variables serveur 



Document XML 



Controleur 



Nouvelle session 
Nouvel Ami 



Patron XSL 



Vue 



Nouveau message 



o 

i 



Document final 



Nouvel utilisateur 



PHP Saloon 
Figure 2-4 Decomposition SADT complete 



Les interfaces vues par PHP 

A partir du decoupage precedent, nous pourrions tout a fait commencer a 
ecrire le code des objets et des fonctions PHP. Mais ce serait prendre un 
risque important pour la duree de vie de notre application. 

Rien dans ce cas ne nous permettrait d'assurer que le code realise est con- 
forme a notre modele. Pire, meme en faisant abstraction des differences ine- 
vitables qui surgiront entre modele et realisation et en supposant que celles- 
ci ne generont pas le fonctionnement courant du logiciel, que se passera-t-il 
lors des prochaines evolutions ? 

La notion d'interface, telle que l'introduit PHP 5, repond a ce probleme. 
L'interface decrit les pre-requis d'une specification, pre-requis auxquels 
toute implantation doit se conformer. 

Ce pre-requis est donne en listant les prototypes des methodes qui devront 
exister dans l'implantation. 

Cet ensemble va constituer une sorte de contrat a respecter. Un objet ne sera 
declare conforme a une interface que s'il respecte tous les pre-requis. C'est- 
a-dire s'il comporte bien les differentes methodes referencees par l'interface. 
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L'exemple suivant, tres simple conceptuellement, va nous permettre de 
decouvrir l'approche adoptee par PHP avant de nous lancer dans la defini- 
tion effective des interfaces de PHP Saloon. 

L'idee est de definir une interface a la notion de fichier (par exemple pour rea- 
liser une implantation reseau compatible avec une version de reference clas- 
sique). Les methodes obligatoires imposees dans l'interface pourraient etre : 

• ouvrir ; 

• fermer ; 

• lire ; 

• ecrire. 

Peu importe la nature exacte de l'implantation, tout fichier compatible devra 
offrir ces quatre methodes. En PHP, on ecrirait : 

interface fichier { 

function ouvri r($nom) ; 
function fermer() ; 
function lire($nombre) ; 
function ecri re($donnees) ; 

} 

La syntaxe adoptee par PHP est elementaire. Par la suite, lors de la realisa- 
tion effective d'un type d'objet fichier, on pourra preciser que celui-ci res- 
pecte notre interface comme suit : 

class fichier_traditionnel implements fichier { 
function ouvri r($nom) { 

} 

function fermer() { 
} 

function lire($nombre) { 
} 

function ecri re($donnees) { 
} 

} 

On observe immediatement le gain en lisibilite ; avant meme de regarder le 
detail de la classe fichier_traditionnel on sait que celle-ci disposera au 
moins des fonctionnalites decrites dans l'interface fichier. 

Naturellement, au-dela de ce gain immediat, l'important est de savoir que 
tout type d'objet qui voudra implanter la specification fichier devra disposer 
des methodes ad hoc. Sinon, le code sera refuse par le moteur PHP avant 
meme son execution. 



Un type d'objet peut implanter plusieurs interfaces differentes, on pouvait 
s'y attendre. En reprenant notre exemple, on peut definir une nouvelle 
interface : 

interface manipulations { 

function copier($nouveaunom) ; 

function effacer(); 

function deplacer($nouveaunom) ; 

} 

Et compte tenu de celle-ci, on pourrait imaginer une implantation de la 
classe fichier plus sophistiquee que la precedente, qui remplirait les condi- 
tions imposees par les deux interfaces fichier et manipulation : 

class fichier_etendu implements fichier, manipulations { 

...II definition de toutes les methodes imposees par les 
interfaces. 
} 



B.A.-BA Prototype et signature 

Le prototype d'une fonction (le terme mathematique est signature) 
ne s'interesse pas au code de la fonction. II constitue lui-meme une 
sorte d'interface, de specification. Dans un prototype, on precise en 
reprenant le plus souvent la syntaxe du langage : 

• le nom de la fonction ; 

• les parametres en entree ; 

• le resultat. 

PHP n'etant pas type, on se contente la plupart du temps de preci- 

ser le nombre des parametres en les nommant (le nom utilise pour 

le prototype ne sera pas necessairement repris par I'implantation) : 

function example (Sparaml, $param2); 

Cependant il est possible de definir plus precisement la nature des 

parametres en precisant le type d'objet attendu : 

function exemple (Classl Sparaml, Class2 $param2) ; 

B.A.-BA Objet, classe et methodes 

Enfin si aucun parametre n'est specifie, PHP n'effectue aucune veri- 
fication. La fonction pourra alors comporter autant de parametres 
souhaites. 

Dans cet ouvrage, nous allons beaucoup evoquer les objets avec 

des termes qui peuvent parfois preter a confusion. 

Ainsi la notion de classe, qui peut paraTtre obscure, ne represente 

en realite rien d'autre que I'extension aux objets de la notion de 

type. 

Une classe, c'est done la definition d'un type d'objet. Dans la classe, 
on precise la nature des donnees stockees (on parle d'attributs) et les 
fonctions disponibles pour manipuler I'objet (on parle de methodes). 



Une fois la classe definie, on peut alors effectivement creer les 
objets en tant que tels. [.'operation de creation porte le nom d'ins- 
tanciation. Chaque objet represente une instance (un exemplaire) 
du type defini par la classe. 

Le modele objet ne se contente pas de reprendre la notion de type, 
il complete cette notion en assurant notamment la protection des 
donnees avec la possibility de definir certains attributs ou methodes 
comme elements prives. Ceux-ci ne seront alors pas accessibles par 
des objets ou des fonctions tiers. Seules les methodes de I'objet dis- 
poseront du droit d'acces. 

B.A.-BA Implantation ou implementation 

Le terme implantation est courant, il designe le code effectivement 
realise pour repondre a un besoin en general decrit dans un cahier 
des charges ou des specifications. 

L'important est de ne jamais oublier qu'une meme demande peut 
donner lieu a un grand nombre d'implantations differentes. En 
effet, il existe bien plus d'une maniere de realiser un logiciel, et il 
est souvent souhaitable, voire necessaire, de disposer d'implanta- 
tions specifiques (a un materiel ou pour les tests). 
C'est la que I'usage des interfaces est crucial : il va permettre de 
normaliser les echanges entre les implantations de chaque module. 
Le respect de ces normes permet ensuite de modifier les implanta- 
tions sans risques pour les autres modules. 
A noter qu'on utilise souvent I'anglicisme equivalent : implementa- 
tion. 



41 



A ce stade, il est important de ne pas melanger interface et heritage multiple 
classique. Les interfaces ne sont pas des classes au sens commun du terme. 
Leur role ne releve pas du domaine de l'implantation. Leur vocation est de 
decrire et de normaliser une interface de programmation. 

Compte tenu des elements precedents, une crainte legitime quant aux inter- 
faces est de s'interroger sur levolutivite du code ainsi realise. Nous sommes a 
meme de nous poser des questions. Pourra-t-on le reutiliser ? Comment le 
faire evoluer ? 

Dans les deux cas, derriere une apparente rigidite, les interfaces constituent 
au contraire un facteur de dynamisme. En ce qui concerne la reutilisation, la 
presence d'une interface claire permet de mieux determiner la correspon- 
dance entre les besoins et le type d'objet convoite, ce qui simplifie l'identifi- 
cation des objets reutilisables. 

Enfin, les interfaces peuvent elles-memes etre etendues par heritage, exacte- 
ment comme les objets eux-memes. II est done possible de faire evoluer en 
parallele les objets et les interfaces et proposer ainsi simultanement plusieurs 
versions de bibliotheques de composants. 

interface manipulations_etendues extends manipulations { 
function compresseO ; 

} 

On le voit, les interfaces introduites dans PHP 5 apportent une reelle amelio- 
ration en matiere de developpement logiciel. Dans PHP Saloon, ces interfaces 
vont nous permettre de figer les interactions entre nos modules et ainsi clarifier 
les echanges, puis permettre de tester des implantations differentes. 

La vue 

Compte tenu de la decomposition deja realisee, on constate que le seul role 
de la vue dans PHP Saloon est de transformer le document XML, d'ou 
l'interface PHP suivante : 

interface iVue { 

function transforme($document, Sstyle); 

} 

Voila, nous venons de definir la premiere interface de PHP Saloon. Pour le 
moment, la nature exacte des parametres est encore inconnue. Le moment 
venu, nous preciserons le type de ces parametres. 



Le contrdleur 



Le cas du controleur n'est guere plus complexe ; en effet, la plupart des flux 
d'information que nous avons detectes precedemment sont lies au modele. Le 
controleur se contente de realiser les traitements sur les donnees de celui-ci. 

La seule methode indispensable d'un controleur est celle qui est responsable 
de la production du document XML. Nous pouvons done proposer 
l'interface : 

interface iControleur { 
function genere() ; 

} 

En fonction des pages appelees par le visiteur, le controleur realisera des 
operations d'agregations sur des donnees plus ou moins compliquees, mais 
en realite, du point de vue exterieur, seule 1' operation de generation est 
importante. 

Nous pourrions done en rester la, cependant, et bien que notre interface soit 
tout a fait valide, nous allons adopter une version legerement modifiee : 

interface iControleur { 
function saveXMLO; 

} 

Cette derniere mouture anglophone nous permettra, par la suite, de tirer 
profit d'objets PHP disponibles en standard. 



Le modele 

Le cas du modele est plus complexe. C'est en effet lui qui va nous fournir le 
moyen d'acceder aux donnees. Au lieu de definir une seule interface globale, 
nous allons adopter une approche plus modulaire et definir pour chaque type 
de donnees manipulees une interface propre. 

Les donnees de session 

Lobjet session en lui-meme est elementaire. Son role va consister a gerer un 
compteur de temps. Lorsque l'utilisateur est actif, le compteur est mis a jour 
et chaque page de PHP Saloon teste la date de derniere mise a jour via notre 
objet session, pour decider de l'expiration ou non de la session en cours. 

Deux methodes doivent done etre implantees pour tout objet session : 

• la mise a jour du compteur de session pour preserver sa validite ; 

• le test d'expiration. 



On peut done proposer l'interface suivante : 

interface i Session { 
function update() ; 
function active () ; 
} 

Les listes (('information 

Outre les sessions, PHP Saloon manipule de nombreuses listes, parmi les- 
quelles, les listes de connectes et les listes d'amis. On peut done logiquement 
esperer pouvoir definir une interface commune a ces listes. 

En realite, il est meme possible d'aller plus loin en utilisant les conclusions 
proposees pour un design pattern tres classique : l'iterateur {iterator). 

Le design pattern iterateur decrit des situations oil il est necessaire de par- 
courir une suite d'elements (par exemple nos listes de connectes). C'est un 
cas tres courant dans le developpement logiciel. 



METHODE Design patterns 

Les design patterns sont d'abord une preuve de bon sens, lis reposent sur un constat simple : 
meme si chaque logiciel est specifique, une tres large partie des problemes conceptuels ren- 
contres lors du developpement se retrouve d'un projet a un autre. L'approche des design pat- 
terns vient completer la notion de bibliotheque, qui est plus adaptee aux problemes techni- 
ques purs et peu transposable a la resolution de problemes d'architecture logicielle. 
Sans aller jusqu'a proposer des solutions techniques pretes a I'emploi, les design patterns 
offrent pour chaque situation une analyse precise et une proposition de moderation - on 
pourrait presque dire, un guide de developpement. 

On peut decrire autant de design patterns que Ton souhaite, chacun repondant a une situa- 
tion donnee, cependant il existe un jeu de design patterns tres usuels, ceux-ci sont en gene- 
ral decrits dans les ouvrages consacres au sujet. 

Chaque projet peut ainsi tirer profit de I'analyse du probleme qu'ont deja realisee les 
meilleurs specialistes. II est important d'avoir toujours en tete le concept du design pattern 
avec PHP 5, car ceux-ci ont tres largement inspire les developpeurs. 



II propose une interface type que nous allons tout simplement reprendre. 
interface Iterator implements Traversable 

{ 

function rewindQ; 



function current () ; 
function key() ; 



function next() ; 
function valid() ; 

} 



L'interface retenue est tres classique. Dans le cas de PHP Saloon, les elements 
de la liste seront des connectes au chat. 

L'adoption de cette interface recele par ailleurs un avantage particulier. En 
effet, PHP lui-meme utilise cette interface pour certaines operations, c'est le 
cas notamment de l'instruction foreach. 

En utilisant l'extension SPL, nous allons pouvoir directement utiliser l'ins- 
truction foreach sur nos listes au lieu de recourir nous-memes aux methodes 
currentO, next() et valid()... Une simplification syntaxique importante et 
surtout un gain en lisibilite appreciable vont en decouler. 

Les messages 

L'utilisation de l'interface i terator va aussi apporter son lot de simplification 
a la gestion des messages. Celle-ci comporte trois actions-cles : 

• la transmission effective d'un message a un interlocuteur ; 

• la creation du formulaire d'envoi ; 

• l'affichage du fil de discussion en cours. 



< L'extension SPL definit une interface abstraite, 
traversable, dont derivent toutes les interfa- 
ces du type iterateur. 



< Lors du parcours d'un objet traversable un 
pointeur permet de connaitre a chaque instant la 
position courante parmi la sequence d'elements. 
Rewind () repositionne le pointeur vers le tout 
premier element. 

< CurrentO renvoie I'element courant et incre- 
mente le pointeur de sorte qu'il designe I'ele- 
ment suivant dans la sequence. 

< Key() designe une de d'acces a I'element. 
L'interface ne dit rien quant a la nature de la de, 
chacun est libre d'implanter le concept comme il 
le souhaite. 

< Next() incremente le pointeur et retourne I'ele- 
ment associe. 

< Appelee hasmore() en phase de developpe- 
ment cette extension permet de savoir si la fin 
de la sequence est atteinte ou s'il reste des ele- 
ments a parcourir. 
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Les deux premieres etapes nous permettent de proposer une interface par- 
tielle du type : 

interface i Message { 

function nouveau(); // creation du formulaire 
function transmet(); // sauvegarde du message envoye 

} 

Pour le fil de la discussion, on retrouve le desormais classique parcours d'une 
liste (ici des differents messages echanges). On peut done tout a fait 
reprendre l'interface iterator. L'objet controleur qui creera la page au 
moment venu n'en sera que plus simple. 

On aboutit done a l'interface : 

interface iMessage extends iterator { 
function nouveau(); 
function transmet(); 

} 



REGARD DU DEVELOPPEUR [.'extension SPL 



L'extension SPL ecrite par Marcus Boerger, contributeur majeur a 
PHP, ne se borne pas a definir une interface pour le design pattern 
iterator mais s'applique a tout un jeu de patterns classiques. 
De plus, dans cette optique, le code de I'interpreteur PHP lui-meme a 
ete revu pour tirer profit de ses interfaces quand cela est possible. 
C'est le cas notamment pour I'instruction foreach. 
Fo reach opere normalement exclusivement sur les 
tableaux, c'est notamment le cas dans PHP 4. 
Stableau = array ( 1, 2 , 3); 
foreach (Stableau as Selement) { 
print Selement; 

} 

Cependant, on peut constater sans difficulty que les 
fonctions proposees dans l'interface iterator suffi- 
sent a parcourir le tableau du debut a la fin. 
Dans PHP 5, le code de foreach a done ete reecrit de 
maniere a ne requerir que les fonctions de l'interface 
iterator. II est alors possible d'utiliser foreach sur 
tous les objets qui implantent cette interface. 
Cette meme logique s'est appliquee a la gestion des 
tableaux dans PHP 5. Pour peu qu'il nous faille respec- 
ter une interface ad hoc, toute classe pourra utiliser la 
notation [] auparavant reservee aux seuls tableaux 
PHP. 

Pratiquement, l'extension SPL est partie integrante de 
PHP 5 et devrait etre activee par defaut dans toutes les 



versions. Si vous devez compiler vous-meme votre interpreter PHP, il 
est possible de s'assurer de la chose en utilisant I'option -enable- 
spl lors de la phase de configuration. 

L"activation de l'extension peut etre verifiee en utilisant le tradition- 
nel phpinfoQ, une section dediee a SPL est alors presente : 



3 phpinfoQ ■ Microsoft Internet Explorer 
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Figure 2-5 Activation de l'extension SPL dans PHP 5 



46 



En resume 



Nous avons decoupe notre application selon le modele MVC et defini les 
interfaces necessaires pour baliser ce decoupage : 

interface iVue { 

function transforme($document, $style); 

} 

interface iControleur { 
function saveXMLO ; 

} 

interface iSession { 
function updated 
function active() ; 

} 

interface iMessage extends iterator { 
function nouveau(); 
function transmet(); 

} 

Le perimetre a respecter par l'implantation est done desormais determine. II 
serait done maintenant tout a fait possible de confier le developpement de 
chaque module aux differents membres d'une equipe. Mais la definition de 
ces interfaces permettra aussi aux plus temeraires de realiser sans risques des 
implantations alternatives a celles que nous allons maintenant realiser. 



< Generation du document final (html) 



< Sauvegarde du document DOM en XML 



< Mise a jour du compteur de session 

< Test de I'anciennete de ce compteur 



< Creation du code XML pour un formulaire 

< Transmission d'un nouveau message 



L'ensemble de nos listes de connectes respectera 
I'interface iterator. 
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Modele de donnees 
avec SQLite 



Une application Internet est rarement creee pour un 
seul utilisateur. II faut done assurer la sauvegarde et 
l'acces partage a l'information. 
C'est l'objet d'un systeme de gestion de base de 
donnees tel que SQLite que nous utiliserons pour 
stocker l'ensemble des donnees manipulees dans 
PHP Saloon. 



SOMMAIRE 

► Definition du modele de 
donnees 

► Realisation avec SQLite 

► Premiers tests 

MOTS-CLES 

Entite/relation 
Modele conceptuel 

► Modele physique 
SQL 

► Contraintes d'integrite 



Construire un modele de donnees, c'est mettre a plat et decrire toutes les 
informations qui devront etre conservees, meme apres l'execution d'un pro- 
gramme. Ce travail est indispensable quel que soit le langage de developpe- 
ment, meme s'il est objet ! 



Un modele de donnees : pour quoi faire ? 

Nous venons de le voir, PHP 5 permet de creer des objets, ce sont eux que 
nous manipulons dans PHP Saloon, notamment au niveau du controleur. 

Cependant ces objets : 

1 ne sont pas partages entre les differentes instances des programmes 
PHP; 

2 sont detruits a la fin du processus de creation de la page web (qui coin- 
cide avec la fin du programme PHP). 

Cela signifie qu'avec les seuls objets PHP, rien ne survit a la page en cours 
(ni les messages, ni les inscriptions). On pourrait naturellement prendre soin 
de stacker manuellement ces objets dans des fichiers. II serait alors possible 
de les recuperer a chaque debut de script PHP. 

Une telle methode repond a la premiere objection mais laisse la seconde en 
suspens. En effet, comment partager sans risques ces informations quand 
plusieurs utilisateurs vont vouloir consulter ou modifier les objets stockes 
dans nos fichiers ? 

Le probleme decrit ici est celui de faeces concurrent a l'information. Con- 
trairement a ce qui est le plus souvent mis en avant, un systeme de gestion de 
base de donnees (SGBD ou DBMS en anglais) n'a pas comme seul objectif 
de stacker l'information (on voit qu'il nous serait aise de tout stacker dans 
des fichiers, mieux, PHP est susceptible de le faire pour nous avec les ses- 
sions, voir le chapitre suivant), mais aussi d' assurer la gestion des acces con- 
currents a une meme information. 

Dans PHP Saloon, nous allons done confier le stockage permanent des 
informations contenues dans nos objets a un SGBD (SQLite). Pour cela, il 
va nous falloir decrire ces informations (qui ne sont pas necessairement celles 
contenues exactement par les objets). 

Le modele de donnees constitue cette description de l'information a stacker. 
II existe plusieurs methodes pour representer et decrire ce modele, une des 
plus simples et des plus repandues en France est la methode Merise. Elle est 
assez largement destinee au type de SGBD le plus repandu : les SGBD rela- 
tionnels. 



B.A.-BA Les tests Acid pour les bases de donnees 

La question de I'acces concurrent a I'information est un point crucial pour toute application 
transactionnelle, ce qui est le cas du commerce electronique mais aussi de la plupart des 
echanges inter-entreprises, et ceci bien avant I'ere d'lnternet. 

Un jeu de prerequis de references a done ete mis au point pour s'assurer qu'un SGBD 
garantit les proprietes indispensables a I'execution de transactions concurrentes, il s'agit 
des proprietes Acid (de nombreux tests existent pour verifier la conformite a ces proprietes. 
La signification de cet acronyme est : 

• atomicite ; 

• coherence ; 

• isolement (isolation) ; 

• persistance [durability). 

L' atomicite garantit que chaque transaction se comporte comme une botte noire dont I'exe- 
cution n'est pas decomposable. En outre, I'isolement garantit que les differents utilisateurs 
concurrents n'auront aucune visibility sur les changements d'etats a I'interieur de la transi- 
tion, chacun observant successivement I'etat anterieur et I'etat posterieur a I'execution des 
transactions concurrentes. 

L'ensemble des instructions d'une transaction devra naturellement respecter les contraintes 
d'integrite inherentes aux modeles de donnees (ce qui garantit la coherence de la base sur 
la duree). 

Le SGBD devra assurer la permanence des changements operes dans une transaction des 
lors que celle-ci est validee. Ceci meme en cas de crash. 



Ces SGBD stockent I'information sous forme de tables et la methode Merise 
va nous permettre de decrire de maniere generique (independamment du 
SGBD choisi) les tables (entites) et les associations qu'elles entretiennent. 



Description avec Merise 



La methode Merise est particulierement adaptee pour decrire un modele de 
donnees. Plus ancienne qu'UML, elle reste la methode de reference pour ce 
type de description et dispose d'un pare logiciel considerable, y compris dans 
le monde Open Source. 

Merise impose de decouper l'analyse des donnees en deux phases. Une pre- 
miere etape conceptuelle permet de decrire les entites (dans Merise on ne 
parle pas d'objet) et les relations (associations) entre elks sans entrer dans les 
contraintes du systeme de stockage. 

La deuxieme etape consiste a traduire, pour un type de stockage donne, le 
modele conceptuel en un modele physique adapte. Dans cette etape, les 
entites du modele conceptuel sont transformees en tables et les associations 
donnent lieu a la creation de contraintes d'integrite entre tables (cks etran- 
geres par exemple). 



OUTIL NetObjects 



II est souvent difficile de trouver un equivalent 
libre aux outils metier comme Sybase Powerdesi- 
gner ou Rational Rose, cependant pour Merise et 
entite/relation, qui sont assez proches, il existe 
NetObjects. Cet outil permet de modeliser de A a Z 
un modele de donnees et de generer le code SQL 
pour la plupart des SGBDR du marche. 
► http://nextobjects.sourceforge.net 
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Figure 3-1 Modele de donnees avec la methode entite/relation 



ALTERNATIVES UML et entite/relation 

La methode Merise est tres repandue en France mais d'autres methodes sont utilisables 
pour decrire nos donnees, c'est le cas de la methode Entite/Relation ou d'UML, qui est tres 
utilisee dans le monde objet. 

Pour PHP Saloon, il aurait naturellement ete possible d'utiliser un environnement de deve- 
loppement UML a tous les niveaux. Cependant : 

• UML requiert en soi un ouvrage. 

• Rares sont les IDE capables de gerer le code PHP (il est vrai que cela n'a de sens que 
depuis PHP 5). 

• Enfin il n'est pas evident qu'UML soit le choix le plus judicieux pour decrire un modele de 
donnees elementaire. 

Les experts UML pourront cependant se pencher sur Waterproof ::U ML, un tout nouvel outil 
de developpement UML prevu specifiquement pour PHP et qui vient completer le deja cele- 
bre PHPEdit. 

► http://www.waterproof-software.com/ 

B3 Pascal Roques, Cahier du programmer UML, Eyrolles 2002 

ID Pascal Roques, UML par la pratique, Eyrolles 2003 
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Figure 3-2 

Modele de donnees avec UML 



Dans le cas de PHP Saloon, il est done necessaire en premier lieu d'identi- 
fier pour chaque classe d'objets les informations a stocker de maniere perma- 
nente. 

Si Ton considere par exemple le cas d'un utilisateur, il est necessaire de 
memoriser son pseudo, le mot de passe associe et son age. A ceci s'ajoute un 
identifiant unique, qui va nous servir de cle d'acces a toutes ces informations 
(dans les schemas, la notation PI, primary identifier, est utilisee). 

Nous pourrions utiliser aussi le pseudo comme cle d'acces, celui-ci etant 
unique, mais dans l'interrogation de la base il est toujours plus facile de com- 
parer un simple numero qu'une chaine de caracteres. 

On obtient done l'entite de la figure 3-3. 
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Figure 3-3 Entite utilisateurs 
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Chaque attribut de l'entite dispose d'un type, qui n'est pas le type physique 
qui sera utilise au final, mais plutot un type logique. Cette technique assure 
une relative independance du modele conceptuel par rapport au SGBD qui 
implantera le modele physique. Ainsi, VA255 indique une chaine de carac- 
teres de taille variable (d'ou le VA) d'au maximum 255 caracteres. On indique 
par ailleurs le caractere obligatoire ou non de 1'attribut (avec la lettre M pour 
mandatory). La notation peut varier d'un outil a un autre mais le concept 
reste le meme. 

Nous devons proceder de meme pour toutes les entites manipulees dans 
PHP Saloon, sans oublier de preciser les differentes associations. 

Une association va mettre en evidence la relation entre deux ou plusieurs 
entites. On precisera en general les attributs qui sont correles et les cardina- 
lity . 

Pour PHP Saloon, on obtient alors le schema conceptuel de la figure 3-4. 
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Figure 3-4 Modele de donnees conceptuel de PHP Saloon 



Les informations liees au profil des utilisateurs ont ete regroupees dans une 
entite separee. II devient alors possible de proposer la creation de plusieurs 
profils pour un meme utilisateur. 



54 



L'association appartient materialise la relation entre les deux entites profils 
et utilisateurs. En effet, dans l'entite profils, l'attribut utilisateur repre- 
sente necessairement la cle d'acces a un utilisateur decrit par l'entite 
utilisateurs. Cette contrainte va ainsi eviter que ne se creent des profils 
fantomes sans utilisateur associe. Lorsque le SGBD utilise au moment de 
l'implantation le prend en charge, ce type de contrainte permettra meme 
d'effacer automatiquement les profils associes a un utilisateur lors de sa sup- 
pression. 

Le meme type d'association est precise pour l'entite messages dont les attri- 
buts expediteur et destinaire representent tous deux une cle d'acces a un 
utilisateur. 

Notre choix etant fait pour le type de stockage (un SGBD relationnel), nous 
pouvons transformer ce premier schema en un modele physique, qui va 
decrire non plus des entites mais des tables et des contraintes portant sur 
celles-ci. 
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Figure 3-5 Modele physique des donnees 



METHODE Modele conceptuel de donnees 

La definition d'un modele conceptuel de donnees 
n'est en rien obligatoire. On aurait tout a fait pu 
creer le modele physique immediatement. 
Cependant, la creation d'un modele conceptuel 
offre plus de souplesse en permettant de se con- 
centrer sur les donnees sans d'emblee etre con- 
fronte aux contraintes du modele relationnel. 



On obtient alors notre modele de donnees final. Dans le cas present, la plu- 
part des entites ont ete directement transformees en tables et les associations 
en contraintes d'integrite. On observe cependant que l'association a donne 
lieu a la creation d'une table. La transformation du modele conceptuel en 
modele physique n'est done pas toujours aussi elementaire qu'il n'y parait. 



Mise en oeuvre de SQLite 

Le modele physique doit lui-meme etre transforme pour un SGBD donne. 
Si le langage utilise par tous les SGBD relationnels est SQL, chacun en 
etend les possibilites ou helas en elimine d'autres. Bref, au-dela d'un socle 
minimal, il faut savoir adapter au cas par cas. 

Avant d'aller plus avant dans la transformation, il faut done regarder d'un 
peu plus pres ce qui se cache derriere SQLite. 



ATTENTION Utiliser SQLite comme SGBD 
peut aussi avoir des inconvenients 

SQLite est agreable lors des tests car il va accep- 
ter un code SQL plus large que ce qu'il implante. 
II importe de reserver la methode aux phases de 
test et de mise au point : 

• Des risques de comportements differents sur le 
SGBD choisi pour la production peuvent persis- 
ted 

• L'exportation des donnees de SQLite vers la 
production peut se reveler delicate si les con- 
traintes d'integrite ne sont pas respectees (ce 
qui au terme de la mise au point ne devrait 
plus etre le cas neanmoins). 



SQLite, un SQL classique 

Du cote du langage SQL, SQLite adopte une approche reellement originale 
en etant compatible a priori avec la syntaxe du langage la plus complexe (y 
compris les contraintes d'integrite), meme si au final un certain nombre 
d'elements sera ignore. Lapproche classique consiste plutot a refuser les 
constructions non compatibles. 

Linteret de cette methode est double : 

• II devient possible d'utiliser un code SQL standard avec SQLite, ce qui 
veut dire qu'il n'y a aucune penalite a commencer avec SQLite avant 
peut-etre d'adopter une base plus lourde, en production par exemple. 

• Si par chance certaines fonctionnalites sont compatibles avec les prochai- 
nes versions, cela le sera de maniere transparente. 

Ainsi, SQLite va done ignorer toutes les definitions de contraintes liees aux 
associations de notre modele conceptuel. Aucune verification ne sera par 
exemple faite pour s'assurer que la cle utilisateur de la table profil represente 
bien effectivement un utilisateur existant dans la table. 

Autre simplification, qui est de taille, au moment de la creation de table, 
comme nous l'avons vu precedemment, chaque attribut se voit associer un 
type, chaine de caracteres, entier... SQLite va tout simplement ignorer 
l'ensemble de ces definitions pour ne retenir qu'un type de stockage : la 
chaine de caracteres. Un certain nombre de verifications ne seront done pas 
faites, mais fondamentalement le modele reste le meme. On imagine com- 
ment la mise au point d'une application peut etre ainsi facilitee. 
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ATTENTION SQLite ne supporte pas les procedures stockees 

Si le support SQL de SQLite est plutot complet, il n'est cependant pas possible de realiser de 
procedures stockees. 

Les procedures stockees sont des procedures ou fonctions definies dans un langage propre 
au SGBD (mais en general on propose aussi les langages de scripts courants) et qui sont 
executees directement par le SGBD lui-meme dans les requetes. 

II en resulte de meilleures performances car la manipulation des donnees est effectuee au 

sein du SGBD sans aller-retour entre le programme utilisateur et la base. De plus, certains 

SGBD vont stacker le code des procedures de maniere optimisee. 

A defaut de procedures stockees, I'extension SQLite de PHP permet de faire appel a 

n'importe quelle fonction PHP via une fonction interface. Par exemple : 

select php('strTen' , 'abc'); 

Cette requete va executer la fonction PHP strTen sur la chaine 'abc' et retourner 3. Tou- 
tes les fonctions PHP sont ainsi accessibles depuis le code SQL. 

Attention, ce mecanisme n'est disponible que pour I'extension PHP et ne Test done pas 
pour les autres clients SQLite, comme le client en ligne de commande. 



A l'inverse, SQLite supporte parfaitement un point essentiel, si Ton tient 
compte de la definition donnee precedemment d'un SGBD : les transac- 
tions. Vbus ne rencontrerez aucune difficulte pour creer une application de 
commerce en ligne et il est inutile de definir des tables de quel que type que 
ce soit. SQLite prend en charge les transactions nativement. 

SQLite, un SGBD sans serveur 

Autre originalite de l'approche, la quasi-totalite des systemes de SGBD rela- 
tionnels met en oeuvre un logiciel serveur (sous Windows un service). 
Chaque programme se comporte en client et doit se connecter au serveur, le 
plus souvent en utilisant les protocoles reseau classiques (ceux-la meme qui 
sont utilises entre un navigateur et le serveur web consulte). 

La consequence de cette architecture, certes robuste, est une certaine lour- 
deur. II faut effectivement administrer le serveur, en verifier le bon fonction- 
nement et mettre en oeuvre les protocoles pour s'y connecter. 

Avec SQLite, rien de tout cela, le moteur qui execute les instructions SQL 
n'est plus dans un serveur mais dans une simple bibliotheque. Et les donnees 
sont stockees dans un fichier. Difficile de faire plus simple. 

Inutile alors de se demander si son hebergeur dispose de serveurs de base de 
donnees, de s'interroger sur leur nature, il suffit de se munir d'un PHP avec 
I'extension SQLite (elle est disponible par defaut) pour pouvoir utiliser le 
potentiel d'un SGBD relationnel et du langage SQL. 

Cette approche prend aussi tout son interet dans la creation d'applications non 
plus forcement web mais de logiciels autonomes, par exemple en utilisant 
PHP-GTK. II devient possible de disposer en standard d'un SGBD integre. 



EXTENSION PHP-GTK 

PHP-GTK est une extension de PHP qui ajoute au 
langage le support de la bibliotheque GTK (Gnome 
ToolKit). II s'agit d'une bibliotheque graphique 
multi-plates-formes qui permet de creer de verita- 
bles applications graphiques aussi bien sous MS- 
Windows que GNU/Linux. 
PHP-GTK constitue done un environnement com- 
plet pour creer des applications autonomes. 
► http://Gtk.php.net 
la home page du projet PHP-GTK. 
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SQLite est done particulierement seduisant pour le developpement rapide 
d'applications ou quand la charge ne necessite pas une base digne des plus 
grandes multinationales. 



Si vous decouvrez SQL, sachez que ce langage 
constitue la reference pour manipuler les donnees 
stockees dans les SGBD (relationnels principale- 
ment). Les bases du langage sont aisement com- 
prehensibles, on pourrait presque lire les instruc- 
tions comme du mauvais anglais. Bien entendu, le 
langage ne se limite pas aux instructions relative- 
ment simples, mises en ceuvre dans PHP Saloon, et 
si vous souhaitez en savoir plus, SQL draine une li- 
terature abondante. 

a C. Soutou, De UML a SQL, Eyrolles 2002. 
Q G. Gardarin, Bases de donnees, Eyrolles 1999. 
Q F. Brouard, SQL Developpement, Campus Press 
2001. 



Implantation de notre modele 

Tables et contraintes 

SQLite va nous permettre de proceder a une transformation standard de 
notre modele physique en SQL. Loutil utilise pour realiser les schemas de 
cet ouvrage et generer le SQL a ete configure pour PostgreSQL, un des 
SGBD les plus connus du monde Open Source avec MySQL. Le code 
genere sera pourtant tout a fait correctement interprets par SQLite... 

On constate que ce code SQL comporte en realite deux parties : 

• la creation des tables proprement dites ; 

• les contraintes d'integrite sur le modele. 

Les contraintes sont ignorees dans la version actuelle de SQLite. Cepen- 
dant, si vous souhaitez utiliser une base de donnees plus classique, ce code 
sera pleinement pris en compte. 



ALTERNATIVES Le support des SGBD par PHP 

PHP propose une interface a la quasi-totalite des bases de donnees du marche, depuis 
Microsoft SQL Server a Oracle, en passant par PostgreSQL ou MySQL. 
Pour PHP Saloon, nous mettons SQLite en avant, cependant le code SQL utilise est tout a 
fait standard, une tres large majorite des SGBD supportes par PHP peuvent done etre utili- 
ses. II suffit pour cela de remplacer les quelques instructions SQLite par leurs equivalents. 



Requetes SQL dans PHP Saloon 

Dans PHP Saloon, outre la creation des tables et l'integration des con- 
traintes dans celles-ci, qui ne s'effectuent qu'une seule fois, nous allons exe- 
cuter abondamment 3 types de requetes SQL : 

• sel ect pour des interrogations ; 

• i nsert pour des insertions ; 

• delete pour des suppressions. 

Les interrogations consistent a isoler, parmi les donnees stockees dans les 
tables, celles qui respectent un certain nombre de contraintes. Ces donnees 
peuvent alors etre extraites de la base de donnees pour etre utilisees. 
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Pour obtenir l'integralite des informations d'un profil, on va extraire pour un 
utilisateur donne l'ensemble des colonnes des tables profils et utilisateurs : 

sel ect 

profils.*, utilisateurs.* 
from 

profils, utilisateurs 
where 

utilisateurs. uid = profils. utilisateurs$$ 
and 

utilisateurs. uid = 3 

order by 

profils.pseudo 
asc 

Ces operations de selection n'ont de sens qua la condition d'avoir au prea- 
lable pu inserer des donnees, c'est le role de l'instruction insert. Ajoutons un 
deuxieme profil a l'utilisateur portant le numero 3 : 

insert into 
profils 

( id, ville, region, cv, utilisateur) 
values 

( 3 , 'Paris', 1 , 'Fan de PHP 5', 3) 

Enfin, le troisieme type d'instruction a etre largement utilise dans PHP 
Saloon est delete, qui va nous permettre d'effacer les sessions expirees ou de 
supprimer un utilisateur de test : 

delete from 

utilisateurs 
where 

uid = 3 

Tester SQLite en direct 

Toutes ces requetes SQL vers la base de donnees vont naturellement etre 
executees par les objets PHP au sein meme du code de PHP Saloon. PHP 5 
definit pour ce faire 3 classes : 

• sqlite_db : une connexion sqlite ; 

• sqlite_query (et sql ite_ub_query en variante non bufferisee) : le resultat 
d'une requete ; 

• sqlite_exception : exception eventuellement levee. 



< Selection des colonnes a isoler. 



< Tables impliquees. 



< Conditions a verifier. Ici, on fait le rapproche- 
ment entre un profil et l'utilisateur qui en est le 
proprietaire (on parle de jointure entre les tables 
utilisateurs et profils), en I'occurrence l'utilisa- 
teur dont I'identifiant est 3. 

< L'instruction select dispose d'options qui per- 
mettent d'ordonner les donnees ou de les 
regrouper. On souhaite avoir les profils classes 
par pseudo pour cet utilisateur. 



< Table dans laquelle inserer les donnees. Si seules 
certaines colonnes comportent des donnees, 
celles-ci sont precisees entre parentheses. 

< Donnees a inserer. 



< | Table dans laquelle effacer les donnees. 

< Condition optionnelle. Sans condition, toutes les 
lignes de la table sont effacees. 
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B.A.-BA Variante non bufferisee 

Lorsqu'on execute une requete SQL, le resultat est 
construit en memoire. II occupe done naturelle- 
ment de I'espace et si le nombre de lignes retour- 
nees est important, il nous faut beaucoup 
d'espace. 

Dans ce cas, on a done tres souvent interet a ne 
pas construire I'integralite du resultat a I'execution 
de la requete mais au contraire a ne delivrer pro- 
gressivement que les elements demandes. 
SQLite permet de ne pas faire exploser I'espace 
memoire occupe par le script PHP (en general 
limite a 8 Mo). Dans le cas des SGBD classiques, 
cela evite en plus de faire transiter inutilement des 
donnees sur le reseau. 



PHP 4 Sqlite est aussi disponible via des 
fonctions tres classiques 

Si vous utilisez PHP 4, pas de panique ! L' extension 
SQLite definit certes des classes, ce qui est la 
maniere la plus simple de faire dans I'univers 
objet, mais les fonctions classiques comme celles 
disponibles pour les autres bases n'ont pas pour 
autant disparu. 

Vous pourrez ainsi utiliser sql ite_connect() 
ou sql ite_query() d'une facon tres similaire a 
celle proposee dans le code. 



Chaque classe dispose de methodes qui vont permettre d'interagir avec les 
bases SQLite. 



Tableau 3-1 Methodes de la classe sql i te_db 



Mot hnrio 


Docrrintinn 

UC3U ipilUII 


cj u s py 


Pvo/~iitinn rl una cam iota 

eacluliuii u uiic icqutric. 


array_query 


Execution d'une requete et retour de I'integralite des valeurs sous 

fnirriQ rlo t^n ciai i 
lUllllc Uc LdUlcdU. 


single query 


Fxpriitinn H'unp rpnuptp pt rptnur Hp nrpmiprp rolonnp rip tnui 
les resultats. 


unbuffered_query 


Execution d'une requete sans prechargement des resultats. 


1 ast_i nsert_rowi d 


Retourne I'identifiant de la derniere ligne inseree. 


c reate_agg regate 


Creation d'un agregat. 


create_f unction 


Creation d'une fonction. 


busy_timeout 


Retourne le delai d'attente maximal en vigueur lorsque la base est 
bloquee par une autre instruction. 


last_error 


Retourne le numero de la derniere erreur. 



Tableau 3-2 Methodes de la classe sql ite_query 



Methode 


Description 


fetch_array 


Recuperation de la ligne courante du resultat sous forme de tableau. 


fetch_object 


Recuperation de la ligne courante sous forme d'objet. 


fetch_si ngle 


Recuperation de la premiere colonne de la ligne courante du resultat. 


fetch_all 


Recuperation de I'integralite du resultat de la requete sous forme de 
tableau. 


col umn 


Retourne la valeur d'un element dans la ligne courante du resultat. 


changes 


Retourne le nombre de changements operes par la requete. 


num_fields 


Retourne le nombre de colonnes dans le resultat. 


field_name 


Retourne le nom d'une colonne. 


current 


Retourne la ligne courante dans le resultat. 


next 


Retourne la ligne suivante dans le resultat. 


prev 


Retourne la ligne precedents dans le resultat. 


hasprev 


Vrai si la ligne courante n'est pas la premiere dans le resultat. 


rewi nd 


Revient a la premiere ligne du resultat. 


num_rows 


Retourne le nombre de lignes du resultat. 


seek 


Permet de se positionner parmi les lignes du resultat. 


valid 


Vrai si la ligne courante n'est pas la derniere dans le resultat. 
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Une sequence classique d'utilisation est la suivante : 



$db = new sqlite_db('base.sqlite') ; 

$db->query(' create table foo ( bar int not null)'); 

$db->query('insert into foo values ( 4 )'); 

$db->query(' insert into foo values ( 5 )'); 

print_r($db->array_query('select * from foo')); 

?> 

Par ailleurs, SQLite dispose d'interfaces orientees vers de nombreux lan- 
gages. La bibliotheque peut bien sur etre utilisee nativement en C, mais 
aussi avec le langage Tel ou encore en Perl. A ces interfaces, s'ajoute un petit 
utilitaire en ligne de commande. Ce programme permet d'interroger directe- 
ment un fichier SQLite. Cette possibilite est evidemment particulierement 
utile pendant les phases de mise au point. II est ainsi aise d'observer le 
resultat des actions realisees en PHP et de suivre revolution de la base. 



ADOdb & Pear DB 



T«ra Term - 10.128.0.251 VT 



Kile Edit Setup Control Window Help 



Dans PHP Saloon, nous utilisons les methodes et 
fonctions SQLite natives. C'est une bonne maniere 
de comprendre le fonctionnement de la base, mais 
cela altere neanmoins la portability du code. 
Deux couches d'abstraction majeures existent pour 
PHP. Au sein de Pear tout d'abord, avec Pear DB. 
Sous forme de bibliotheque pour ADOdb, egale- 
ment. 

Dans les deux cas, il s'agit de permettre d'executer 
les memes instructions quelles que soient les bases 
a interroger. Ce n'est pas toujours possible et on 
aura interet a rester sur du SQL tres standard. 
A ce jour, ADOdb semble offrir une robustesse et 
une richesse dans le support des SBGD des plus 
importantes. En outre, le support de PHP 5 est bien 
integre, notamment avec la prise en compte de 
I'interface SPL, comme c'est le cas dans PHP 
Saloon. 

► http://pear.php.net 

► http://php.weblogs.com/ADODB 



vl:/tmpf php -f tcst.php 

Array 

( 

[01 »> Array 



( 



[0] => 4 
[barl »> 4 



Til -> Array 



( 



[0] => 5 
tbarl -> 5 



. Tera Term - 10.128.0.251 VT 



tile Edit Setup Control Window Help 



v1 :/r.mp# 



Figure 3-6 

Resultat du programme de test 



vl:/var/ww# sqlito tost 






SQLite version 2.8.5 






Enter ".help" for i nstructi nns 






sqlito select * from utilisatcurs; 






l|st£| secret | 31 






2 \m\mu Imnmi] 1 12 






sqlito select * from profils; 






l|l|PARIS|Fan de PHP 5|l|st£| 






?.\ |Paris| |2|agla<M 






sqlito select * from sessions; 






14717abe349e87ela341fa59a48144a7| 1068126414 |uid |s: 1 


"l";itiai |i: 1068137878; 




f}a2e14ms?nflc1 fln50ef!2f fG3SMr,f r.(il 1 1 Ofifll 1fi53!) | ui d | s : 1 


"2";maj |i : 1 Dfifsl 'iOnqfi; 




sqlito | 






T 













Figure 3-7 Execution de requetes en ligne de commande 
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SQLite et les transactions 

Le programme client en ligne de commande sqlite est aussi un moyen 
simple de tester le fonctionnement du mecanisme des transactions. 

Le principe d'une transaction est simple. La transaction agit comme un con- 
tainer qui obscurcit certaines des instructions SQL. Quel que soit le nombre 
d'instructions SQL dans une transaction, ceux qui se connectent a la base 
n'auront jamais la vision des etapes intermediaires. lis accederont a la base 
telle quelle etait auparavant si la transaction n'est pas encore terminee, ou en 
verront l'etat final, a l'etape ultime de la transaction. 

En outre, le contenu d'une transaction se deroule integralement ou est 
annule dans sa totalite. La base reste ainsi coherente, quoiqu'il arrive. 

Au sein d'une transaction, comme dans toute instruction SQL, le SGBD 
verifie que les contraintes d'integrite precisees dans le modele sont respec- 
tees. 

En SQL, le contenu d'une transaction est delimite par les instructions begin 
et end. Linstruction rollback permet d'annuler l'ensemble des operations en 
cours de route. II est possible de preciser des le depart la conduite a tenir en 
cas d'erreur, le debut de la transaction est alors : 

begin on conflict reaction 

Avec une reaction qui peut etre : 

• rol 1 back : toute la transaction est annulee ; 

• abort : la transaction est arretee, les changements de l'instruction fautive 
sont annules, ceux effectues par les instructions precedentes demeurent ; 

• f ai 1 : la transaction est arretee, les changements de l'instruction fautive 
realises jusqu'a l'apparition de l'erreur demeurent, tout comme les modi- 
fications des instructions precedentes ; 

• ignore : la transaction est executee jusqu'a son terme, tous les change- 
ments qui ont pu avoir lieu demeurent, par exemple dans une instruction 
de mise a jour. Si la ligne a pose probleme, toutes les autres sont nean- 
moins bien mises a jour ; 

• replace : dans le cas d'une operation d'insertion, si un element declare 
unique pre-existe, l'insertion est transformee en mise a jour. 

Dans PHP Saloon, les transactions sont necessaires. Certaines actions, par 
exemple l'inscription, comportent plusieurs phases. Celles-ci doivent etre 
realisees au sein d'une transaction pour eviter les interferences entre inscrip- 
tions simultanees. On evite ainsi de creer un profil sans finalement pouvoir 
l'associer a un utilisateur ou reciproquement. 



Dans les deux sequences suivantes deux utilisateurs tentent leur inscription 
en parallele et choisissent, helas, le meme pseudo pour leur premier profil. 
L'inscription de l'un des deux va etre totalement annulee. 



Session de Toto 

L'utilisateur Toto s'inscrit et termine sa transaction en premier. 



BHD 



sqlite> begin on conflict rollback! 
sqlite> insert into 

...> utilisateurs ( id, pseudo, motdepasse, age ) 
,,,> values 

...> ( 1, 'toto', 'secret', 25 >; 
sqlite> insert into 

.„„> profils ( id, region, ville, cv, utilisateur, pseudo) 
,..> values 

..*> < 1, 1, 'Paris', 'Fan de PHP', 1 , 'phpman'); 
sqlite> end; 
sqlite> | 



Session de Titi 

L'utilisateur Titi voit sa transaction annulee a la fin, car comme Toto, il a 
voulu nommer son profil phpman. 



BHD 



sqlite> begin on conflict rollback; 
sqlite> insert into 

...> utilisateurs ( id, pseudo, motdepasse, age ) 

...> values 

.„> ( 2, 'titi', 'mystere', 32); 
sqlite> select * from utilisateurs; 
II toto I secret 1 25 
2 1 titi I mystere 1 32 
sqlite> insert into 

**»> profils < id, region, ville, cv, utilisateur, pseudo) 

...> values 

...> ( 2, 1, 'Lyon', 'Autre Fan de PHP', 2, 'phpman'); 
SQL error: uniqueness constraint failed 
sqlite> select * from utilisateurs; 
1 1 toto I secret 1 25 
sqlite> | 



Les transactions vont nous permettre de preserver l'etat de coherence dans 
notre base de donnees. 



Creation d'une vue connectes 

A ce stade, notre modele de donnees et les outils necessaires pour le mani- 
puler en toute securite sont complets. Toutefois, SQL et SQLite permettent 
la creation de vues, et ceci va nous simplifier encore le travail sur les donnees. 

Meme si la structure des requetes SQL est simple, on comprend assez facile- 
ment que le regroupement de donnees eclatees dans plusieurs tables va 
donner lieu a des instructions select a rallonge. C'est notamment le cas 
lorsqu'il s'agit d'identifier les connectes. II faut en effet reunir les donnees de 
trois tables, sans oublier naturellement les conditions qui portent sur les 
colonnes. 

Si la requete ne doit etre utilisee qu'une fois, cela ne porte pas a conse- 
quence, si par contre, comme on l'imagine pour la liste des connectes, la 
requete fait l'objet de nombreux appels, alors il devient particulierement ardu 
de reproduire l'integralite du code SQL. 



CONNECTES 

pseudo 

age 

ville 

region 

cv 

photo 
uid 



0 profils 

0 utilisateurs 

0 sessions 



Figure 3-8 La vue CONNECTES 
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Le langage permet done de definir des vues. Une vue est une sorte d'alias, 
qui cree une table virtuelle a partir du resultat d'une instruction select. 

Pour PHP Saloon, nous allons definir une bonne fois pour toutes la requete 
indispensable pour obtenir les connectes et en faire une vue, que nous allons 
naturellement appeler CONNECTES. 

create view 
CONNECTES 

as // requete qui correspondra a connectes 
select 

profils.pseudo as pseudo, 

// as permet de renommer un champ dans le resultat final 
utilisateurs.age as age , 
prof ils.vi lie as ville, 
prof i Is. region as region, 
profils.cv as cv, 
profils. photo as photo, 
utilisateurs.id as uid 
from 

profils, utilisateurs, sessions 
where 

utilisateurs.id = profils. utilisateur and 
php('session: :getSessionData' , sessions. data, 'uid') = 
utilisateurs.id and 
( php('time') - 

php('session: :getSessionData' , sessions. data, 'maj ')) 
< 120; 

Dans cette vue, nous avons utilise la possibilite d'appeler des fonctions PHP 
depuis les requetes SQL. Elles nous permettent de decoder le contenu des ses- 
sions (voir le chapitre suivant) ou d'obtenir le resultat de la fonction PHP ti me. 

Par la suite, et pour toutes les requetes, nous pourrons utiliser connectes 
comme une table classique. Pour selectionner les connectes, il suffira done 
d'executer : 

select * from connectes; 

Cette maniere de proceder concourt de meme a mieux decouper le travail. 
Dans un projet professionnel, les specialistes du modele de donnees cons- 
truiront pour les createurs de l'application les acces adaptes aux donnees, que 
ce soit sous forme de tables ou de vues. 



En resume 



Dans ce chapitre, nous avons resolu le probleme de la persistance des infor- 
mations manipulees en commencant par en faire le tour de maniere precise 
avec le modele conceptuel de donnees (MCD) de Merise, puis en utilisant 
SQLite pour tout stocker. Ce SGBD relationnel, a l'apparence anodine, 
voire simpliste, se revele au final tout a fait sympathique. Puissant sans etre 
contraignant, il permet de realiser rapidement une application test sans pour 
autant hypothequer un basculement vers des bases plus lourdes. 



chapitre 



V uulisateur.php + (/var/www/v2/inc) - CVIM1 



File Eiiil Tuuls Synla* Buflfccs Winiiuw 



HQ 

Help 



r equ i r e_once 'session. php' ; 

class utilisateur { 
private Sdb; 
private Sid; 
private Spscudo; 
private Smotdepasse; 
private Sage; 

function construct ( Spseudo - false, Smotdepasse - false, $aqe - 10) ( 
$thic->pccudo = Spccudo; 
Sthis-">motdepass© = Smotdepasse; 
Sthis->age = Sage; 

I 

function oonnccto( Sdb) { 

Sid = Sdb-^single_c|uery( "select id from utilisateurs where pseud 
' (Sthis->pseudo) ' and motdepasse- ' (Sthis->motdepasse) ) ; 
if (Sid) ( 

Ssession = new session(120) ; 
S_SESSION['uid' ] - $id; 
Ssess ion->updat e ( ) ; 
Lelui.ii true; 



) 

return false; 
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Les objets dans PHP 5 



Le developpement objet dans PHP n'a jamais ete 

en vogue. Et pour cause, les capacites du langage 

en la matiere etaient tout simplement primitives. 

PHP 5 bouleverse cet etat de fait, comme nous allons le voir 

avec la classe utilisateur de PHP Saloon. Protection des 

donnees, utilisation generalised de references : PHP 5 prend 

les choses en main. 



SOMMAIRE 

► Le modele objet 

► Sa mise en oeuvre dans PHP 

► Les extensions de PHP 

MOTS-CLES 

► Encapsulation 
Heritage 
Methodes 
Attributs 
Reference 




seudo 
password^ 



Avant de decouvrir les choix effectues par les concepteurs de PHP 5, il est 
important de bien comprendre ce quest un objet. Historiquement parlant, la 
quasi-totalite des langages dispose de la notion de structure, ou de celle de 
record dans les langages derives de Pascal. 

La structure permet d'agglomerer en un seul element plusieurs donnees dis- 
tinctes. On peut ainsi creer une structure pour manipuler la notion d'utilisa- 
teur dans PHP Saloon. Une telle structure grouperait le nom de code de 
l'utilisateur connecte et son mot de passe, tout cela en une seule entite, soit 
dans le langage C : 

typedef struct { 

char *pseudo; 

char *motdepasse ; 
} utilisateur; 

L'objet propose un modele beaucoup plus elabore que ce collage elementaire 
en apportant trois niveaux d'amelioration : 

• la protection des donnees de l'objet et la definition d'interfaces pour le 
manipuler ; 

• la possibilite de definir des objets non seulement par composition mais 
aussi par extension ; 

• le controle repousse le plus tard possible de la nature exacte de l'objet afin 
de gagner en souplesse. 



structure 




pseudo 
password 



objet 

Figure 4-1 

La protection des donnees par l'objet 



Encapsulation et protection des donnees 

Seul inconvenient a cette structure : les donnees agglomerees sont librement 
accessibles. 

Reprenons l'exemple de notre structure utilisateur. Rien ne nous empeche 
d'aller modifier directement le nom de code au sein de cette derniere, ceci 
meme si nous avons pris soin de creer une fonction changepseudo pour cela. 

Naturellement, si par la suite nous devons modifier la maniere dont est 
memorise ce nom de code (par exemple pour le completer par le prenom), 
les problemes surgiront de toutes parts. Chacun peut modifier ce que bon lui 
semble dans les variables de type utilisateur. 

Une objection consiste a faire remarquer qu'il suffirait de rendre obligatoire 
l'utilisation de la fonction changepseudo. L'experience montre helas que letre 
humain, et plus particulierement l'informaticien, est globalement peu sen- 
sible a ce type de directives. 



68 



Avec l'objet, l'innovation porte sur la notion de protection des donnees. Au 
lieu de donner libre acces a l'information dans une sorte de structure 
poreuse, l'objet se definit comme une enceinte impermeable, meme au deve- 
loppeur, qui va proteger les donnees contenues. On parle d'encapsulation des 
donnees et il s'agit probablement de la caracteristique la plus importante 
d'un objet. 

En paralkle a cette protection, l'objet va disposer de methodes. Ces 
methodes sont des fonctions qui lui sont associees et elks vont servir d'inter- 
faces entre le monde exterieur et les donnees contenues dans l'objet. L'objet 
fonctionne ainsi comme une boite noire : on ne sait pas ce qu'il contient et 
comment il fonctionne, mais par chance nous disposons de methodes pour le 
controler. 

Dans notre exemple, la fonction changepseudo est une methode de l'objet 
utilisateur. Elk permet en toute securite de modifier le pseudo. Si demain, 
la structure interne de notre objet est modifiee, il suffira d'adapter cette 
methode et les utilisateurs de notre objet ne seront pas impactes. 

Dans la pratique, on est souvent amene a manipuler des objets de meme 
nature. Mais on ne souhaite pas avoir a redefinir pour chaque objet ses attri- 
buts et ses methodes. On utilise pour cela la notion de classe. 

Une classe va servir a decrire un type d'objet et sera ensuite utilisee comme 
un moule, un modele pour fabriquer a volonte autant d'objets desires. Pour 
nos objets utilisateur, on peut ainsi definir une classe et les creer de cette 
facon : 



class utilisateur { 
var Spseudo; 
var Spassword; 

function changepseudo($nouveau_pseudo) { 
$this->pseudo = $nouveau_pseudo; 

} 

function changepassword($nouveau_password) { 
$this->password = $nouveau_password; 

} 

function litpseudoO { 
return Spseudo; 

} 

function litpasswordO { 
return Spassword; 

} 



} 

$ul 
$u2 



new utilisateurO ; 
new utilisateurO I 



changepseudo 



changepassword 




pseudo 

password I litpseudo 



litpassword 



Figure 4-2 Attributs et methodes d'un objet 
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V utilisatgur.php + (/var/www/v2/inc) - CVIM1 








File Edil Tuuls Synla* Buffets WinUuw 




Help | 










require_once ' session . php' ; 








class utilisateur 

private Sdb; 
private $id; 
private $pcoudo; 
private Srootdepasse; 
private Sage; 

function construct (Spseudo - f alse, $rootdepasse - 
$thic->pcoudo = $pccudo; 
St his -">motdepasse = $mot depasse; 
Sthis->age = Sage; 


false, $aqe 


- 10) ( 




function connect c | $db) { 

$id = $db- - >single_query ( "select id from utilisateurs where pseud 
o - ' {Sthis->pseudol ' and motdepasse- ' i$this->motdepasse) ' " ) ; 
if (*id) { 

{session = new session ( 1 20) ; 
$_SESSION[ 'uid' ] - $id; 
$session->update( ) ; 
LeLuLii true; 




j 

return false; 


1 fi,.12-4fi 


5* 





Figure 4-3 Premiere version de la classe utilisateur 



Ce code est valide a la fois en PHP 4 et en PHP 5. L'instruction new est uti- 
lisee pour creer de nouveaux objets, comme dans une tres large majorite de 
langages objet. 



SYNTAXE $this et I'operateur -> 

PHP ne verse pas dans I'originalite pour ce qui est de son implantation du modele objet. 
Comme pour new, la plupart des notations courantes ont ete adoptees par PHP. 
Ainsi la variable Sthis, disponible dans toutes les methodes d'objet, designe I'objet lui- 
meme. C'est done avec cette variable qu'on accede aux attributs et aux methodes de I'objet 
courant dans une methode. 

Enfin, I'operateur -> permet de designer les methodes ou les attributs manipules : 
$ul->pseudo = 'titi ' ; 
$ul->changepseudo('toto') ; 

Contrairement a d'autres langages, PHP n'utilise pas la notation pointee. Deux notations 
n'auraient d'ailleurs pas de sens dans un langage sans pointeurs et oil desormais tous les 
objets sont traites comme des references. 



Protection des donnees : les 3 « P » 



Si Ton retrouve bien la notion d'objet et de classe dans le code precedent et 
dans PHP 4, aucune protection des donnees n'est malheureusement realisee, 
malgre ce qu'on pourrait supposer. Ainsi, il est tout a fait possible d'alterer la 
valeur de l'attribut pseudo sans passer par les methodes definies : 

$ul->pseudo = 'Pirate'; 

En PHP 4, il n'existe aucun moyen simple pour eviter cela. Cet etat de fait 
traduit la realite de l'implantation du modele objet dans PHP 4. Les objets y 
sont construits comme de simples tableaux associatifs. 

PHP 5 complete ce modele objet initial en ajoutant la protection des don- 
nees. La solution retenue est classique et ne se distingue en rien des langages 
objet courants. Celle-ci repose sur trois niveaux de protection : 

• public ; 

• protege (protected) ; 

• prive (private). 

Le tableau ci-dessous resume l'impact de cette classification sur faeces aux 
donnees (attributs ou methodes). 



Acces 


Public 


Protege 


Prive 


A partir de la classe elle-meme 






V 


A partir de classes derivees 


*> 


✓ 


X 


De I'exterieur 


*> 


X 


X 



Pour proteger nos attributs, le code precedent peut done etre reecrit : 

class utilisateur { 
private Spseudo; 
private Spassword; 

function changepseudo($nouveau_pseudo) { 
$this->pseudo = $nouveau_pseudo; 

} 

function changepassword($nouveau_password) { 
$this->password = $nouveau_password; 

} 

function litpseudo() { 
return Spseudo; 

} 

function litpassword() { 
return Spassword; 

} 

} 



PNP4 La compatibility reste assuree 

Par defaut ou si var est utilise, les attributs sont 
consideres publics, ce qui garantit la compatibilite 
avec PHP 5 des objets et des classes definis dans 
PHP 4. 
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SYNTAXE Methodes statiques 



La plupart du temps, les methodes s'appliquent sur 
un objet precis. Toutefois, il peut etre utile de defi- 
nir des methodes transversales applicables hors du 
contexte particulier d'un objet. 
PHP 5 propose done la definition de methodes, 
dites statiques. Ces methodes vont etre utilisables 
sans qu'un objet ne soit necessaire. La syntaxe uti- 
lised est alors : 

nomdelaclasse: :nomdelamethode() ; 



1 V utilisatour.php + (Aor/www/v2/inc) - CVIM1 








File Edil Tuuls SynUus Buffers WinUuw 




Help | 










require_once * session .php* ; 








class utilisateur ! 

private Sdb; 
private Sid; 
private Spccudo; 
private Sraotdepasse; 
private Sage; 

function construct (Spseudo - false, Srootdepasse - 
$thic->pccudo = Spscudo; 
Sthis~">motdepasse = Smotdepasse; 
Sthis->age = Sage; 


false, Saqe - 


10) { 




i 

function conncctc(Sdb) { 

Sid = $db->single_query("sele8t id from utilisateurs where pseud 
o = ' {Sthis->pseudo) ' and motdepasse= ' {Sthis->motdepasse} ' " ) ; 
if (Sid) { 

Ssession = new session(120) ; 
S_SESSION['uid' J - $id; 
Ssession->update( ) ; 
relui.ii true; 




j 

return false; 


] h, i"'-Jh 


5* 





Figure 4-4 Classe utilisateur avec attributs prives 

Les mots-cles public, private ou protected sont utilises en lieu et place de 
var. Avec cette adaptation, il devient alors impossible d'acceder indument 
aux attributs pseudo et password : 

$u = new utilisateur() ; 
$u->pseudo = 'Toto' ; 

Le code provoque une erreur : 

Fatal error: Cannot access private property utilisateur: :$pseudo in 04- 
04. php on line 20 

Ces deux notions reunies font de PHP 5 un veritable langage objet. D'autres 
facilites vont etre disponibles, cependant le cceur du concept objet est desor- 
mais la : encapsulation et protection des donnees. 



Heritage 

Parmi les facilites traditionnellement associees au modele objet, l'heritage 
figure en general en bonne place. La notion de classe permet deja de dis- 
poser d'un moyen pour recreer des objets d'un meme type. L'heritage va 
apporter une simplification supplemental dans la definition des classes 
elles-memes en autorisant la programmation par extension. 

Ainsi, avec l'heritage, une classe fille pourra etre definie comme l'extension 
d'une classe parente. On peut alors creer une veritable hierarchie de classes 
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derivant les unes des autres. Dans PHP Saloon, on pourra par exemple 
etendre notre classe utilisateur ou, pour simplifier la mise en oeuvre de 
l'architecture MVC, definir une classe racine controleur et etendre celle-ci 
avec les fonctions specifiques liees a chacun des modules (identification, ins- 
cription...). 

PHP utilise le mot-cle extends pour associer une classe fille a sa classe 
parente. Ainsi, pour notre classe utilisateur on pourrait definir : 

class utilisateurabonne extends utilisateur { 
private $numero_client; 
function lit_numero_client() { 
return $thi s->numero_cl ient; 

} 

function change_numero_cl ient($nouveau_numero) { 
$this->numero_client = $nouveau_numero; 

} 

} 

Dans ce cas, un objet de type utilisateurabonne comportera trois attributs 
prives et six methodes distinctes. L'heritage, qui pourrait etre simplement vu 
comme une facilite syntaxique (en evitant de redefinir des elements de classe 
en classe), apporte done avant tout une coherence globale entre les classes et 
constitue un facteur de reutilisation et de qualite des developpements. 

II faut noter qu'en matiere d'heritage, PHP 4 et PHP 5 sont totalement 
compatibles. Les hierarchies de classes concues pour PHP 4 devraient done 
etre fonctionnelles, et ce sans difficultes, avec PHP 5. Naturellement, 
aucune protection des donnees ne sera assuree. 



REGARD DU DEVELOPPEUR Etendre n'est pas composer 

Quand on decouvre le modele objet et l'heritage, la tentation est grande de voir des rela- 
tions d'heritage entre toutes les classes. Cette surutilisation du concept aboutit en general 
a un usage deforme du modele ou de la notion d'heritage, tout en produisant I'effet con- 
traire a celui attendu en matiere de lisibilite et de clarte des developpements. 
Plus particulierement, il est essentiel de ne pas confondre I'extension d'une classe en une 
nouvelle classe qui la precise, et la composition, qui consiste a integrer dans cette classe 
des objets d'autres types. 

Ainsi, une classe berline peut logiquement etendre une classe voiture. Mais ce serait 
une erreur de vouloir etendre la classe roue en lui ajoutant la classe derivee voiture. Une 
voiture pourra par contre comporter un attribut roues (par exemple, un tableau de 4 
objets de classe roue). 

Cet exemple est trivial et ne prete pas a confusion, mais dans la realite des developpements, 
il n'en va pas toujours de meme. C'est pourquoi il convient de se souvenir a chaque instant, 
qu'objet ne veut pas dire heritage. Cette moderation est particulierement bienvenue dans un 
langage comme PHP (ou C++ par exemple) dont le fondement reste procedural. 



Heritage et interfaces 

La mecanique d'heritage disponible sur les objets est aussi disponible sur les 
interfaces (voir le chapitre 2). II est alors possible de definir, en parallele avec 
la hierarchie des classes et des objets, une hierarchie des interfaces. Le terme 
d'extension revet alors tout son sens, puisqu'il s'agit de definir, via les regies 
d'heritage, des extensions d'API. 

class utilisateurabonne extends utilisateur implements iutilisateur, 
iabonne { 

// code de la classe. 

} 

On note cependant que si pour les interfaces, comme pour les classes, l'heri- 
tage multiple n'est pas pris en charge, une classe d'objets peut implementer 
plusieurs interfaces. On peut voir ces implementations multiples comme une 
composition au niveau des interfaces, comme il est possible de composer les 
objets au sein d'une classe. 



REGARD DUDEVELOPPEUR Heritage multiple 

Un sujet de discorde permanent consiste a se demander s'il doit etre permis de definir des 
classes derivees de plusieurs classes parentes. C'est la notion d'heritages multiples. 
Dans cette hypothese, la hierarchie des classes se transforme en graphes ou est reliee a plu- 
sieurs arbres a priori distincts. 

On peut alors, pour reprendre notre exemple des voitures, definir berl ine comme a la fois 
une extension de la classe voiture, mais aussi de la classe produitjiautdegamme. Dans 
ce cas, on relie une hierarchie qui definit la nature de I'objet a une hierarchie qui definit les 
produits. 

Plus communement, I'heritage multiple sera utilise pour faire de voiture I'extension de 
roue, moteur et autoradio ! Ce qui est une catastrophe en termes de conception. 
Plusieurs langages ont choisi de ne pas introduire cette notion d'heritage multiple ; c'est le 
cas de PHP 5. 



Classes abstraites et finales 

Meme si les interfaces ne representent pas conceptuellement des classes 
objet, on peut toutefois les rapprocher d'un autre raffinement du modele 
objet compatible avec PHP 5 : les classes abstraites. 

De telles classes ne peuvent etre instanciees, c'est-a-dire que toute tentative 
de creation d'un objet de ce type est impossible. II s'agit de classes qui decri- 
vent en general des elements generiques dont seules les classes derivees sont 
en realite exploitables. 

Dans PHP Saloon, on pourrait par exemple revoir notre hierarchie de classe 
en definissant utilisateur comme une classe abstraite dont pourrait ensuite 
deriver une classe « normale » : utilisateur_phpsaloon. Tout en n'etant pas 



instanciable, la classe utilisateur pourrait definir les bases imposees d'un 
type objet utilisateur, bases qui seraient alors reprises et completees par 
heritage. 

On le voit, il est possible d'aboutir a un resultat approchant en imposant une 
interface a la classe utilisateur_phpsaloon. C'est l'approche choisie pour 
toutes nos classes. II faut neanmoins remarquer que dans le cadre des classes 
abstraites, il est possible d'imposer plus que l'API, puisqu'une classe abs- 
traite peut definir des attributs. 



Plusieurs manieres de rendre une classe abstraite 

PHP 5 permet de declarer une classe abstraite de maniere directe en utilisant le mot-cle 
abstract : 

abstract class utilisateur { 
} 

Par ailleurs, differentes methodes de la classe peuvent elles-memes etre declarees 
abstraites : 

abstract class utilisateur { 
abstract function connecte() { 
} 

} 

Dans ce cas, il ne suffira pas de construire une classe derivee, mais encore faudra-t-il que 
celle-ci implante une veritable methode connecte pour que la creation d'objets soit possi- 
ble. 



A l'oppose des classes abstraites, non instanciables mais extensibles, PHP 5 
integre aussi la notion de classe finale. Comme le laisse entendre ce terme, 
de telles classes ne pourront pas etre etendues. Elles constitueront en 
quelque sorte des feuilles dans l'arbre des classes. 

Une classe, comme une methode, peut etre declaree finale. On pourra done 
interdire au developpeur, ou par exemple aux utilisateurs d'un composant, de 
redefinir une methode cle : 

class utilisateur { 

final function connecte() { 
// ... 

} 

} 



Polymorphisme 



Jusqu'a present, l'heritage nous a permis d'etendre les classes en completant 
les methodes et les attributs disponibles. Cependant, PHP 5 autorise egale- 
ment les classes derivees a redefinir les methodes existantes. C'est le poly- 
morphisme. Ainsi, non seulement des objets derives disposeront de fonc- 
tionnalites additionnelles, mais encore pourront-ils prendre des formes 
differentes dans leur comportement. 



ARETENIR Le polymorphisme n'est pas la surchage 

On confond parfois la redefinition de certaines methodes dans les cas du polymorphisme et de la 
surchage de methodes. La surcharge consiste a definir des methodes distinctes en utilisant le 
meme nom mais des prototypes differents. A ce jour, PHP 5 ne supporte pas la surcharge. 
Le polymorphisme consiste pour sa part a remplacer une methode par une autre. II s'agit 
done de bien plus qu'une adaptation comportementale. Le prototype demeure inchange. 



Une methode pourra realiser un traitement adapte a chaque classe d'objets 
tout en conservant la meme interface. 

Dans PHP Saloon, on pourrait adapter les methodes entre l'utilisateur 
abonne et l'utilisateur standard : 

class utilisateur { 

function information() { 

return "Utilisateur invite"; 

} 

} 

class utilisateur_abonne extends utilisateur { 
function information() { 

return "Votre etes abonne(e) jusqu'au {$this->expi ration} ." ; 

} 

} 

Quel que soit l'objet utilisateur cree, il devient possible d'utiliser la 
methode informationO sans se preoccuper de la nature exacte de l'objet dis- 
ponible. La methode adaptee est automatiquement utilisee. 

Pour eviter les debordements, PHP permet toutefois de controler la nature 
des objets manipules : on park de « type hinting ». II s'agit en realite d'indi- 
quer a PHP la nature du type attendu en parametre par une fonction. Cette 
fonctionnalite, conjuguee au polymorphisme, donne un code puissant mais 
contenant des garde-fous. 




En reprenant notre exemple precedent, on peut definir la fonction 
detail_uti"lisateur(). Celle-ci est a meme d'afficher un recapitulatif des 
informations liees a l'utilisateur : 

function detai"l_utilisateur($u) { 
// ... 

print $u->information() ; 
// ... 

} 

Une telle fonction ne posera aucun inconvenient tant que le parametre 
requis est bien un utilisateur, abonne ou non. Les choses n'iront pas de 
meme, si un entier est malencontreusement utilise comme parametre. 

Avec le type hinting, PHP 5 va seul prendre en charge le controle de la 
nature de l'argument effectivement passe a la fonction. On peut alors ame- 
liorer la fonction detai"l_uti"lisateur() : 

function detail_utilisateur(uti~lisateur $u) { 
// ... 

print $u->information() ; 
// ... 

} 

Desormais, tout element non conforme sera rejete par PHP lui-meme. 
Cette notion complete parfaitement le polymorphisme puisque l'objet passe 
en parametre nest en aucun cas modifie. Ainsi, un utilisateur abonne vali- 
dera la condition (il s'agit bien d'un utilisateur) sans pour autant etre tronque 
de ses proprietes etendues et l'appel de la fonction detail_utilisateur() 
affichera comme souhaite la date d'expiration de l'abonnement. 



A RETENIR Un mot sur la genericite et les classes templates 

Rappelons qu'il s'agit de definir des classes parametrees par des donnees ou des types dont 
la nature precise ne sera connue qu'au moment de la creation des objets. Le principal usage 
de ces classes generiques est d'implanter des algorithmes (operations sur les piles et les 
files, ou encore matricielles). 

PHP 5 ne propose rien en la matiere. II est vrai que PHP n'etant pas type, I'interet de telles 
possibilites est moindre. 



Constructeurs et destructeurs 



Avec l'heritage, le polymorphisme et les classes abstraites PHP 5 permettent 
de definir des hierarchies de classes et d'objets complexes. Cependant, pour 
le moment, 1'ensemble des objets manipules sont crees vierges de toute ini- 
tialisation. 

II est neanmoins tout a fait possible de definir dans chaque classe une 
methode ayant en charge des operations d'initialisation. Linconvenient 
majeur dans ce procede est le cote manuel et besogneux. Pour chaque objet, 
et pour chaque classe a laquelle il appartient, il faudra prendre soin d'appeler 
les fonctions d'initialisation ad hoc. 

Par chance, PHP 5, comme tous les langages objet, propose la notion de 
constructeur. Le constructeur joue tres exactement le role de la fonction 
d'initialisation precedente. Mais a la difference de celle-ci, il sera automati- 
quement appele par PHP. 

Le nom de ce constructeur est normalise par PHP et il s'agit : 

• soit de construct, notez les deux caracteres soulignes {underscore) « _ » 

prefixant le mot construct (PHP 5) ; 

• soit du nom de la classe elle-meme (PHP 4/PHP 5). 

Dans le cas de notre classe utilisateur, on pourrait par exemple ecrire : 

class utilisateur { 
private Spseudo; 
private Smotdepasse; 
private $age; 

function construct($pseudo = false, Smotdepasse = false, 

Sage = 18) { 
$thi s->pseudo = Spseudo; 
$thi s->motdepasse = Smotdepasse; 
$this->age = Sage; 

} 

// ... 

} 

Lors de la creation d'un objet, les differents attributs sont alors automatique- 
ment initialises, soit avec les valeurs par defaut, soit avec des valeurs fournies 
lors de la creation : 

$u = new utilisateur('PHPFan' , 'Secret', 32); 



Notre exemple est particulierement simple, la classe utilisateur ne derive 
d'aucune classe parente. Considerons maintenant notre classe utilisateur_ 
abonne, il est tout aussi possible de definir un constructeur : 

class utilisateur_abonne extends utilisateur { 

function construct() { 

// ... 

} 

// ... 

} 

Dans cette situation, et cela peut surprendre de prime abord, la creation d'un 
utilisateur abonne va provoquer : 

• l'appel du constructeur de cette meme classe ; 

• mais non l'appel au constructeur de la classe utilisateur. 

Pourquoi un tel comportement ? Pour une raison en realite tres simple. PHP 
ne peut savoir a la place du developpeur comment appeler, et avec quels 
parametres, le constructeur de la classe parente, a supposer d'ailleurs qu'il 
faille appeler celui-ci ! II appartient done au developpeur de choisir explicite- 
ment d'appeler ou non le constructeur parent : 

class utilisateur_abonne extends utilisateur { 

function construct() { 

// ... 

parent: : construct() ; 

} 

// ... 

} 

La notation utilisee reprend la syntaxe adoptee pour les methodes statiques, 
avec comme nom de classe, le mot parent. 

La notion de constructeur peut naturellement etre mise en parallele avec le 
concept de destructeur. Alors que le constructeur est appele lors de la crea- 
tion de l'objet, le destructeur est appele, lui aussi automatiquement par PHP, 
lorsque l'objet doit etre detruit. 

Le nom du destructeur est lui aussi normalise dans PHP 5 : destruct. II 

faut noter que la notion de destructeur n'est pas presente en PHP 4. 

PHP gere lui-meme la memoire et dispose d'un ramasse-miettes {garbage 
collector) integre ; l'utilisation d'un destructeur est moins courante que celle 
d'un constructeur. Cependant, certaines informations, notamment les res- 
sources creees par des extensions, comme les images, doivent etre liberees 
apres utilisation. Le recours a un destructeur est alors indispensable. 



PHP 4 Utilisation des constructeurs 

La syntaxe desormais mise en avant par PHP 5 dif- 
fers de celle utilisee jusqu'a present. II est encore 
possible d'utiliser la notation en vigueur dans 
PHP 4, meme si celle-ci est deconseillee. Les classes 
definies pour PHP 4 ne devraient done pas poser 
probleme. 

A noter, il n'existe pas de destructeurs en PHP 4. 
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Utilisation des objets et references 



Dans PHP, qu'il s'agisse de PHP 4 ou de PHP 5, les donnees sont copiees 
quand elks sont affectees ou passees en parametres. Ce fonctionnement est 
naturel. 

Toutefois, ce qui est naturel pour un tableau ou un entier, peut tourner au 
desastre pour un objet. D'abord en raison de la taille des objets, meme si cet 
argument est tout autant opposable aux tableaux et aux chaines de carac- 
teres, mais surtout en raison meme de l'usage qu'on entend en general faire 
des objets. 

Le plus souvent, on manipulera un objet comme un element unique, sur la 
duree, avec en corollaire, la conservation d'un etat des lieux propre. Cette 
continuite est naturellement brisee par les operations de recopie. L'objet 
copie n'etant alors plus synchrone avec une copie qui, par ailleurs, ne dispo- 
sera pas forcement de la meme duree de vie. 

Une solution consiste a demander explicitement a PHP de ne pas copier les 
donnees mais de transmettre directement une reference vers l'objet original. 
On utilise pour cela le symbole & (a la fois a l'affectation et lors de la defini- 
tion de fonctions). 

$ reference =& $objet_original ; 

function foo(&$objet) { // le passage se fera par reference 
// ... 

} 

Ce precede est tres penible et sujet a de multiples erreurs et oublis. PHP 5 
adopte done une autre philosophie, par ailleurs deja adoptee par de tres 
nombreux langages. 

Dans PHP 5, lorsqu'un objet est cree, ce n'est plus l'objet lui-meme qui est 
retourne, mais une reference vers celui-ci. Cela peut paraitre complexe mais 
il n'en est rien. L'interpreteur PHP tient en effet a jour un entrepot de tous 
les objets en cours d'utilisation et chaque objet se voit numerate. La refe- 
rence de l'objet est done toute trouvee, il s'agit de ce numero. C'est lui qui est 
manipule partout. 

Tout est alors plus simple. Alors qu'il fallait le plus souvent inutilement 
copier l'ensembk des proprietes d'un objet, on ne copie plus aujourd'hui que 
ce numero de reference. Ce numero est suffisant pour acceder si necessaire 
aux informations et aux methodes. 

Ce numero n'est pas un secret. Ainsi, en reprenant notre classe utilisateur, il 
est tres simple de connaitre la reference des objets crees avec un simple print : 

$u = new utilisateur() ; 
print $u; 



On obtient : 
Object id #4 

Ceci nous confirme que nous manipulons l'objet numero 4 (ce qui, manifeste- 
ment, doit, a peu de choses pres, signifier que $u est le quatrieme objet cree). 

Ce changement de mode de fonctionnement apporte de nombreux avan- 
tages, a la fois en termes de vitesse (moins de recopies) et de souplesse 
(moins de memoire occupee), mais il ne sera pas sans poser difficulte aux 
utilisateurs de scripts et d'applications concues pour PHP 4. 



PHP 4 La grande difference 

On le voit, le mecanisme mis en oeuvre dans PHP 5 est a I'oppose 
du mode par copie disponible dans PHP 4. Mime si tout est fait 
pour minimiser I'impact de ce changement de fond, certains objets 
ne fonctionneront pas avec PHP 5, notamment ceux qui reposaient 
(parfois sans le savoir) sur la copie implicite des objets lors de cha- 
que operation (affectation, passage en parametre). 
Pour toucher du doigt la difference essentielle entre les deux ver- 
sions du langage, considerons la classe (triviale) suivante : 

class test { 
var $attribut; 

} 

Et une fonction tout aussi elementaire qui modifie l'objet : 

function foo(Sobjet) { 

$objet->attri but = 'bar'; 

} 

Dans PHP 4, la copie ou le passage en parametre provoquent une 
copie de l'objet. Ainsi le code suivant : 

Sol = new test(); 
$ol->attri but = 'original'; 
$o2 = Sol; 

$o2->attri but = 'bar'; 
print $ol->attribut; 
$ol->attri but = 'original'; 
foo($ol) ; 

print $ol->attribut; 
Va afficher : 
original original 



Dans PHP 5, les objets ne sont manipules que par reference, et cela 
par defaut. On obtient au contraire : 

barbar 

Cette difference a constitue un handicap majeur pour I'adoption 
des objets dans PHP 4. Dans une majorite de cas, il fallait user et 
abuser de I'operateur & pour forcer I'utilisation de references. Ainsi, 
le code suivant se comporte en PHP 4 comme en PHP 5 : 

<? 

class test { 
var Sattribut; 

} 

function foo(&$objet) { 
// Sobjet sera passe par reference 
$objet->attribut = 'bar'; 

} 

Sol = new testO; 
$ol->attri but = 'original'; 

$o2 =& Sol; // $o2 est une reference vers $ol 
$o2->attribut = 'bar'; 
print $ol->attribut; 
$ol->attri but = 'original'; 
foo($ol) ; 

print $ol->attribut; 

?> 

II est toutefois possible de placer PHP 5 en mode compatibility, en 
configurant I'option zend. impl icit_clone dans php. i ni . Nean- 
moins, cette option entrave naturellement tout usage normal du 
modele objet de PHP 5. 

Enfin, il faut noter que I'utilisation systematique de references dans 
PHP 5 devrait permettre (outre les optimisations du moteur Zend) 
au code objet ecrit pour PHP 4 de s'executer plus rapidement. 
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Autres facilites introduites par PHP 5 



PHP 4 Un portage experimental 

Si PHP 4 sortait encore son epingle du jeu en 
matiere d'heritage et d'encapsulation, les fonc- 
tionnalites suivantes sont clairement concues pour 
PHP 5 meme si un portage est disponible pour 
PHP 4. il faut dans ce cas explicitement les activer 
au cas par cas avec la methode overload (). 
Meme dans cette hypothese il faut s'attendre a 
quelques desagrements. D'une part la compatili- 
blite n'est que partielle, il faudra notamment pen- 
ser a retourner systematiquement la valeur true 

dans les fonctions get() et set(). D'autre 

part, I'experience montre que la stabilite n'est pas 
toujours au rendez-vous. 



En complement du modele objet, PHP 5 apporte un lot de fonctionnalites 
techniques visant a gagner en rapidite et a diminuer la quantite de code 
developpe. 

Methodes et attributs dynamiques 

Premier ensemble de fonctions : le support a la volee d'attributs et de 
methodes. Traditionnellement, l'appel a une methode inexistante, comme 
Faeces a des attributs non definis, provoque une erreur et termine l'execution 
du script PHP. 

PHP 5 offre un moyen de contourner ce probleme en permettant de definir 
des hooks ou des handlers qui seront appeles en cas d'echec. Ces methodes 
tres particulieres repondent a des signatures predefinies par le langage et 
peuvent etre definies dans chaque classe : 

function call ($fonction_appelee, Sarguments) ; 

function set($attribut, Svaleur) ; 

function get($attribut) ; 

Ainsi, dans le cadre de la classe utilisateur, il est possible de remplacer les 
differentes methodes par deux implantations adaptees de get et set : 

<? 

class utilisateur { 
private Spseudo; 
private Smotdepasse; 
private Sage; 

function get(Snom) { 

switch(Snom) { 
case 'login' : 

return Sthi s->pseudo; 
case 'password' : 

return Sthi s->motdepasse ; 

} 

} 

function set($nom, Svalue) { 

switch(Snom) { 
case 'login' : 

$this->pseudo = Svalue; 
break; 
case 'password' : 

Sthis->motdepasse = Svalue; 
break; 

} 

} 

} 
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$u = new utilisateurO ; 
$u->login= 'PHPFan' ; 
print $u->login; 
?> 

II faut toutefois noter que ces differentes methodes ne sont appelees que 
pour les attributs non existants. Ainsi, le code suivant va echouer : 

$u->age = 32 ; 
En effet, l'attribut age existe et a ete declare prive. 

Chargement automatise des classes utilisees 

Autre element de simplification : autoload (). Traditionnellement, et plus 

encore avec l'utilisation des objets, on est amene dans les developpements a 
inclure des fichiers complementaires. Par exemple, il est possible d'associer 
au code de chaque classe un fichier dedie. 

II devient alors indispensable de n'oublier aucune des directives include ou 
require. Cette obligation, simple en apparence, reste delicate en termes de 
maintenance et pendant la phase de developpement. 

Pour ameliorer les choses, PHP 5 offre de definir une fonction, la fonction 

autoload (), qui sera appelee chaque fois que la creation d'un objet est 

impossible, parce que la classe demandee est introuvable. A charge de la 

fonction autoloadO d'agir en consequence, en incluant le code requis la 

plupart du temps. 

function autoload(Sclasse) { 

require_once'inc/' . Sclasse . '.php'; 

} 

Ce mecanisme peut sensiblement simplifier la gestion de la modularity, mais 
attention, il requiert neanmoins un peu de rigueur dans l'organisation du 

code et des noms de fichiers. En effet, la fonction autoloadO ne dispose 

que du nom de la classe pour reconstituer le chemin des fichiers a inclure. 

Conage 

Derniere facilite proposee par PHP 5 : le clonage. II est toujours possible de 
creer un objet avec l'instruction new. Cette maniere de faire ne permet pas 
toutefois d'obtenir deux objets identiques apres coup. En effet, rien ne 
permet de tenir compte des evolutions subies par un objet, si ce n'est de les 
reproduire toutes, et dans les memes conditions. PHP 5 propose done l'ins- 
truction clone : 

$objet_clone = clone $objet_original ; 



REGARD DUDEVELOPPEUR _autoload(), oui 
mais... sans espaces de noms 

Les habitues du langage Java ou meme de Perl res- 
teront sans aucun doute sur leur faim avec 

autoloadO tant il est vrai que PHP 5, sur ce 

point, reste en retrait des attentes habituelles. 
Sans alterer en rien la simplicity d'usage de PHP, 
on aurait aime que PHP 5 soit I'occasion d'offrir un 
environnement non seulement adapte a la pro- 
grammation objet (sur ce point I'objectif est 
atteint) mais aussi propice a la creation de fra- 
meworks ou de composants, comme d'ailleurs 
Microsoft a su le faire avec Visual Basic en entou- 
rant un langage simplissime d'outils de compila- 
tion, et de toute la mecanique necessaire pour atti- 
rer les developpeurs de composants. 
Si Ton en revient a Java, PHP 5 aurait notamment 
beaucoup gagne a supporter les namespaces et 
une instruction du type import. Ces apports fai- 
saient d'emblee disparaitre les conflits de nom- 
mage et permettaient d'envisager le developpe- 
ment de composants a grande echelle. 
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A RETENIR Clonage implicite 



Pour doner un objet, il n'est pas forcement indis- 
pensable de definir sa propre fonction cl one(). 

Dans ce cas, PHP fait une copie a I'identique des 
attributs. Cette methode brutale marchera tant 
que des elements complexes, du type ressources 
ou descripteurs de fichiers, ne sont pas mis en 
oeuvre. 



PHP 4 Pas de clonage 

Dans PHP 4, la notion de clonage n'est pas dispo- 
nible, mais comme les objets sont copies a chaque 
affectation (ou passage en parametre), on peut 
considerer qu'un clone implicite est realise dans 
ces situations. 

Ces copies laissent malheureusement a la charge 
du developpeur le traitement des ressources 
(fichiers ou connexions), sur toute la hierarchie des 
classes. 



Pour prendre en charge de maniere personnalisee la duplication d'objets, une 

classe devra definir une methode clone(). Cette methode assurera la copie 

intelligente des elements internes d'un objet. 

Dans le cas de notre classe utilisateur, la methode clone() n'aurait qua 

copier l'ensemble des attributs et serait done inutile. Dans la pratique, il fau- 
drait aussi rouvrir des connexions vers les bases de donnees ou les fichiers... 



class utilisateur { 
private Spseudo; 
private Smotdepasse; 
private Sage; 
private $db; 

function construct($pseudo, Smotdepasse, Sage = 33) { 

// exemple d'une ressource non copiable simplement 
$this->db = new sqlite_db('test') ; 

} 

function clone() { 

// les attributs ont deja ete copies! 
$this->db = new sqlite_db('test') ; 

} 

} 

$o = new utilisateur('PHPFan' , 'secret'); 

$o2 = clone $o; 

?> 

Notre exemple va permettre a chaque objet (celui clone et l'original) de dis- 
poser de sa propre connexion a la base de donnees. 

Les lecteurs les plus perspicaces l'auront probablement devine, ce cas est 
quelque peu caricatural car PHP, gerant seul la duree de vie des objets, serait 
en mesure de constater si la connexion creee par le premier objet est en rea- 
lite egalement utilisee par le deuxieme. On pourrait done penser qu'une 
simple copie des attributs est suffisante, malgre tout. 



La classe utilisateur complete 

La classe utilisateur finalement retenue pour PHP Saloon ne requiert natu- 
rellement pas la mise en pratique de l'ensemble des fonctionnalites desor- 
mais proposees par PHP 5. Trois methodes sont disponibles : 

• connecteO qui va activer une session pour l'utilisateur ; 

• nouveauO qui va inscrire 1'utilisateur au service ; 

• i d() qui permet d'obtenir l'identifiant de l'utilisateur deja inscrit. 

<? 

requi re_once'session.php' ; 
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class utilisateur { 
private $db; 
private Sid; 
private Spseudo; 
private Smotdepasse; 
private Sage; 

function construct($pseudo = false,$motdepasse = false, Sage = 18) 

{ 

$this->pseudo = Spseudo; 
$this->motdepasse = Smotdepasse; 
$this->age = Sage; 

} 

function connecte(Sdb) { 

// $db est une connexion deja ouverte vers la base SQLite 
Sid = $db->single_query("select id from utilisateurs 

where pseudo = '{$this->pseudo}' and 

motdepasse= ' {$thi s->motdepasse} "') ; 
if (Sid) { 

Ssession = new session(120) ; 

$_SESSION['uid'] = Sid; 

$session->update() ; 

returntrue; 

} 

returnfal se ; 

} 

function nouveau(Sdb) { 

Sresultat = $db->query($query = "insert into utilisateurs values 
(NULL, '{$this->pseudo}' , '{$this->motdepasse}' , '{$this->age}')") ; 
if (Sresultat) 

return $this->id = $db->last_insert_rowid() ; 
returnfal se ; 

} 

function id() { 
if ( ! $this->id) 

$this->id = $_SESSION['uid'] ; 
return $this->id; 

} 

} 

?> 



En resume... 

Alors que PHP 4 souffrait dun support objet limite et poussif, PHP 5 
apporte l'ensemble des elements indispensables a la conception d'applica- 
tions de grande envergure. De plus, et dans la logique de simplification 
constante du langage, PHP 5 complete les outils de base d'une multitude 
d'amenagements qui sont propres a rendre le developpement encore plus 
simple et efficace. 
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Bienvenue dans PHP Saloon! - Mozilla 
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Nom de code 
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Done 



Sessions 



La creation de sessions utilisateur est essentielle 
car elle ouvre la voie a la personnalisation d'un site 
en fonction du visit eur en cours. 
Apres avoir demystifie les mecanismes mis en oeuvre 
pour creer les sessions et etudie leur implantation dans 
PHP, nous expliquerons le code de la solution retenue 
pour PHP Saloon. 
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Incontournables sessions 



ALTERNATIVE Identifier 
les visiteurs autrement 

Si les sessions se sont imposees comme moyen 
d'identifier les visiteurs de maniere unique, c'est 
qu'il existe peu d'alternatives aussi efficaces. 
Ainsi, I'identification de I'utilisateur par son 
adresse IP se heurte aux pare-feux qui mas- 
quent en general, derriere une adresse com- 
mune, plusieurs utilisateurs. 
L'authentification proposee par le protocole 
HTTP est pour sa part plus adaptee a la protec- 
tion de repertoires entiers qu'au suivi des utili- 
sateurs. De plus, la gestion en est laissee au 
navigateur, ce qui pose probleme dans le cas 
des postes partages ou en libre service. 



Et dans PHP Saloon ? 

PHP Saloon est un service accessible apres inscrip- 
tion. L'utilisateur doit done s'identifier et etre 
reconnu pendant toute son utilisation du service. 
Les sessions sont done imperatives. 



Le visiteur d'un site se limite rarement a une page. II navigue d'un endroit a 
un autre en suivant les liens proposes. Cet etat de fait est particulierement 
significatif pour l'acces a un service sur abonnement. 

Le probleme qui se pose alors est de savoir reconnaitre le visiteur lors de son 
periple au sein du site. Cela peut paraitre evident a premiere vue mais il n'en 
est rien. Pour s'en convaincre, il faut revenir aux echanges entre le navigateur 
du visiteur et le site. 

Ces echanges sont pris en charge par le protocole HTTP (HyperText 
Transfer Protocol). Le navigateur va effectuer une demande en utilisant ce 
protocole pour tout element des pages visitees (le texte, chaque image, les 
feuilles de styles ou encore les eventuelles applets Java). 

D'une requete HTTP a l'autre, toutes les informations transmises par le navi- 
gateur sont oubliees. On parle de protocole sans etat. Lavantage de tels proto- 
coles est leur simplicite, ce qui les rend simples a implanter et done moins cou- 
teux a utiliser (ce qui explique leur succes dans le monde Internet). 

Au niveau du serveur web (qui repond aux demandes HTTP), on ne peut 
done pas savoir si plusieurs demandes emanent de la meme personne. II en 
va de meme pour notre code PHP. 

Tout l'objectif des sessions est done de marquer le visiteur de maniere unique 
lors de sa premiere demande et d'assurer que cette marque persiste pour les 
demandes suivantes. II sera alors possible de sauvegarder les differentes don- 
nees (on parle de profil) associees au visiteur et a partir de celles-ci, de per- 
sonnaliser les pages proposees. 

La periode pendant laquelle le visiteur est suivi a la trace par ce marquage 
constitue une session. Bien entendu toute session expire apres un moment 
d'inactivite car il serait impossible de conserver pour une duree illimitee les 
marquages de chaque visiteur rencontre. 

Quand un visiteur revient apres l'expiration de sa session ou s'il se presente 
lors d'une nouvelle visite sur le site, il est a nouveau marque et beneficie 
d'une nouvelle session. II appartient alors au site de retrouver les donnees de 
la session precedente, faute de quoi le visiteur ne beneficiera que des donnees 
de la nouvelle session. 

Cette operation de restauration n'est possible que si l'utilisateur dispose 
d'une identification permanente aupres du site. C'est pourquoi l'utilisation 
des sessions (e'est-a-dire le marquage des visiteurs pendant une seance de 
navigation) est le plus souvent completee par une inscription prealable qui 
permet une identification sur la duree. Les donnees de la session en cours 
sont alors sauvegardees et associees de maniere permanente a ce visiteur, qui 
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s'est identifie. Lors d'une seconde visite, il lui sera possible de reassocier les 
donnees sauvegardees a la nouvelle session creee. 



ALTERNATIVE Des sessions anonymes, sans inscription 

La plupart du temps, les sessions sont utilisees pour des services auxquels I'uti lisateur s'ins- 
crit regulierement. Mais les sessions sont aussi un bon moyen de determiner le profil com- 
portemental du simple visiteur. 

Dans cette optique, il n'est pas necessaire que celui-ci soit un abonne au service (meme si 
dans ce cas le croisement d'informations peut etre plus fructueux). 
De nombreuses societes proposent sur cette base d'analyser la frequentation des sites en 
repondant a des questions comme : combien de temps le visiteur passe-t-il sur une page, 
quel est son cheminement au sein du site, quelles sont les pages les plus visitees et dans 
quel ordre... 



Les outils proposes par PHP permettent de 
simplifier 

On le voit, le support des sessions comporte plusieurs aspects bien distincts : 

• le fait de « marquer » le visiteur ; 

• la sauvegarde des donnees du visiteur (comportement, profil) pendant la 
duree de vie de la session ; 

• la sauvegarde permanente intersessions du profil d'un visiteur. 

PHP propose de simplifier la gestion des deux premiers points, le troisieme 
restant a la charge du webmaster du site. Ce qui est naturel puisqu'il appar- 
tient au concepteur du site de determiner comment un visiteur doit s'ins- 
crire, s'authentifier et comment les donnees doivent etre sauvegardees 
(fichier, base de donnees). 

Creation et maintien de la session 

Pour suivre le visiteur d'un site, PHP propose d'associer un identifiant 
unique a sa session. Celui-ci sera associe au visiteur pendant tout son par- 
cours jusqu'a l'expiration de la session. PHP garantit que cet identifiant sera 
unique. 

En pratique, le suivi de session doit etre active avec l'instruction : 
session_start(). A compter de cette activation, l'identifiant de session est 
disponible soit en utilisant la fonction session_id() , soit via la constante 
SID. 



PHP 4 Les sessions dans PHP 4 et PHP 5 



C'est la meme chose ! Si vous avez developpe vos 
propres fonctions d'authentification, ou si vous 
utilisez un script PHP concu a I'origine pour PHP 4, 
vous n'aurez done rien a changer. 



CONFIGURATION Activation 
automatique des sessions 

Si votre site fait un large usage des sessions, il 
peut devenir penible de devoir ajouter l'instruc- 
tion session_start() dans chaque page. 
PHP peut demarrer la session pour vous auto- 
matiquement. Cette possibility est controlee via 
une directive specifique dans le fichier de confi- 
guration de PHP (php.ini) : 
session. auto_start = on; 
Cette option est desactivee par defaut. 
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DANS LA VRAIE VIE Cas des f ermes de serveurs 
ou de repartition sur plusieurs serveurs 

La creation d'un identifiant unique est deja une 
operation complexe pour un serveur, la chose se 
complique lorsqu'il s'agit d'assurer qu'un tel iden- 
tifiant sera unique et accessible sur plusieurs ser- 
veurs. 

Cette situation est notamment celle rencontree 
lorsqu'on repartit la charge des requetes sur plu- 
sieurs serveurs et, par extension, dans les fermes 
de serveurs. 

Le gestionnaire de sessions standard propose par 
PHP n'est pas utilisable dans ces configurations 
(chaque serveur va retourner un identifiant diffe- 
rent pour des requetes potentiellement associees 
au meme visiteur. Cependant plusieurs extensions 
sont disponibles qui permettent de resoudre le 
probleme (on pourra citer I'extension msession). 



La generation par PHP d'un identifiant unique est cruciale - le serveur 
repondant a de nombreuses requetes simultanees, la tache est en effet com- 
plexe. Vbyons comment assurer son maintien tout au long de la session. 

PHP met en place les mecanismes pour assurer cette transmission de page 
en page de maniere (presque) totalement transparente pour le developpeur 
du site. Deux techniques sont utilisees : 

• l'utilisation d'un cookie ; 

• la reecriture automatique des liens et des parametres de formulaires. 

Dans la plupart des cas, PHP utilise un cookie pour stacker l'identifiant de 
session directement sur l'ordinateur du visiteur. Le cookie ainsi stocke par le 
navigateur sera represente au serveur web pour toute demande ulterieure. 
Cette methode est preferable pour mettre en oeuvre les sessions. Helas, elle 
peut echouer si le navigateur ne supporte pas les cookies ou si ceux-ci ont ete 
desactives pour des raisons de securite. 



COMPRENDRE Les cookies 

Le cookie est en quelque sorte une variable (un nom associe a une valeur) qui va etre 
echangee entre le navigateur et le serveur (et done aussi PHP) lors du parcours de pages 
web. Pour mieux comprendre le fonctionnement des cookies, rappelons tres brievement le 
fonctionnement du protocole HTTP, utilise pour acceder aux sites et aux pages web. 
Le protocole HTTP specifie que le navigateur (client) souhaitant acceder a un element 
(page, image), etablit une connexion avec le serveur du site visite et lui envoie une requete 
pour obtenir du serveur I'information demandee. Chaque element qui compose une page 
fait ainsi I'objet d'une sequence demande/reponse . 

A ce stade, il n'est done pas encore question de cookie. Cependant, outre la demande et la 
reponse, le navigateur et le serveur vont s'echanger des informations complementaires. On 
parle de header (en-tete) car dans le cas du serveur, ces informations sont presentees avant 
le contenu de la reponse (une image par exemple). 

Le navigateur peut ainsi preciser au serveur qu'il prefere les documents en francais, qu'il 
sait ou non interpreter les images JPEG et GIF, qu'il dispose ou non d'un plug-in Flash et 
naturellement indiquer sa nature (Mozilla, Safari ou Internet Explorer). Ces informations 
precieuses seront exploiters par le serveur pour delivrer le contenu le plus adapte. 
De son cote, le serveur delivre des en-tetes au navigateur, ne serait-ce que pour indiquer le 
type du document ou preciser si celui-ci peut etre conserve dans un cache. 
Que vient faire le cookie dans ces echanges ? II s'agit tout simplement d'un en-tete supple- 
mentaire que le serveur ajoute et qui sera present dans les echanges entre le navigateur et 
le serveur. Ce cookie est sauvegarde par le navigateur qui I'ajoute ensuite a ses propres en- 
tetes chaque fois qu'une demande concerne le site emetteur du cookie (un cookie n'est dis- 
ponible que pour le site qui I'a cree). Le cookie ainsi retransmis peut etre mis a jour par le 
serveur. 

Notons enfin, que si le cookie peut etre grossierement compare a une variable partagee, il 
dispose de proprietes supplementaires qui permettent de determiner son expiration ou sa 
portee. 
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PHP propose done une methode alternative qui repose sur une modification 
a la volee du code produit par les pages PHP. II va notamment ajouter une 
variable supplemental - PHPSESSID - aux adresses utilisees dans les liens ou 
dans les formulaires. La variable ainsi ajoutee va transporter l'identifiant de 
session. Cette operation est transparente, PHP modifie le contenu de la 
page automatiquement avant que celle-ci ne soit envoyee au navigateur du 
client. 

II s'agit naturellement d'une operation plutot lourde et moins sure que l'uti- 
lisation des cookies, puisque l'identifiant de session est accessible et peut etre 
transmis par erreur a des tiers par l'utilisateur lui-meme. Cependant, cette 
methode fonctionne dans tous les cas et avec tous les navigateurs. 

Dans les versions recentes de PHP, cette option est desactivee par defaut. 
Vous pouvez la reactiver en modifiant les directives suivantes dans le fichier 
de configuration de PHP : 

session. use_onTy_cookies = no 
session. use_trans_sid = yes 



METHODE Contraintes d'utilisation pour session_start() 

On le voit, les cookies sont la methode universellement utilisee pour 
stacker l'identifiant de session. Ceci ne va pas sans contrainte. En 
effet, cette methode impose d'activer les sessions avant la produc- 
tion de la page. La valeur du cookie doit etre transmise au navigateur 
avec tous les en-tetes du protocole HTTP, e'est-a-dire avant le con- 
tenu de la page. 

De fait, on doit toujours placer I'instruction session_start() 
avant tout le reste dans une page, en prenant soin de verifier 
qu'aucun espace ne s'est glisse dans le code HTML environnant, 
notamment si des fichiers sont inclus. 

Voici un exemple classique ou I'appel a I'instruction 
session_start() va echouer. Le code de la page PHP est particu- 
lierement simple : 



<? session_start() ; ?> 
<htmT> 

<headxtitTe>Page de test</titTex/head> 
<body> 

Une page classique 

</body> 

</html> 



Page de test - Manila Firebird 
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Warning: session_startQ [ function, session- start ]: 
Cannot send sessionjcookie - headers already sent 
by (output started at /var/www/book/sl.php:l) in 
/var.'wwwbook sl.php online 1 

Warning: session_startQ [ function, session-start ]: 
Cannot send session cache lirniter - headers already 
sent (output stalled at /var/www/book/sl.php l) in 
/var/Kww/book/sl.php online 1 
Une page classique 

I Done 



Figure 5-1 Caracteres parasites causant 
I'echec de I'activation d'une session 

Dans le cas present, I'erreur est aisement detectable. Cependant, les 
espaces indesirables sont bien moins faciles a reperer, surtout si 
I'appel a sessi on_start() est realise dans des fichiers inclus. 
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Page 1 - Mozilla Firebird 



File Edit View Go Bookmaiks Tools Help 
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Nous avons obtenu notre identifiant de session : 
34b266e5e7297e65afc6afc5da7fd46f 

• Lien vers la cage 2 



Done 



Figure 5-2 Activation de la 
session sur la premiere page 



II n'est pas difficile d'experimenter les sessions. C'est ce que nous allons faire 
avec un site elementaire, constitue uniquement de deux pages : pl.php et 
p2.php. Cette experimentation nous permettra de maitriser la situation pour 
PHP Saloon. 

pl.php 

<? session_start() ; ?> 

<html> 

<head> 

<title>Page l</title> 
<head> 
<body> 

<p> Nous avons obtenu notre identifiant de session : 
<? print session_id() ; ?> 

</p> 
<u~l> 

<~lixa href="p2.php">Lien vers la page 2</ax/li> 
</u"l> 
</body> 
</htm"l> 



Page 2 - Mozilla Firebird 



File Edit View Go Bookmaiks Tools Help 
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Cette page est juste une page de test! 

L'ldenbhant de session qui nous a ete attnbue est 
conserve : 34b266e5e7297e65afc6afc5da7fd46f 



A- 



Done 



Figure 5-3 Transmission de 
I'identifiant a la deuxieme page 



P2, 



php 



<? session_start() ; ?> 

<html> 

<head> 

<title>Page 2</title> 
<head> 
<body> 

<p>Cette page est juste une page de test!</p> 
<p>L'identifiant de session qui nous a ete 
attribue est conserve : <? print session_id() ; ?> 

</p> 
</body> 
</html> 



La page pl.php comporte un lien vers p2.php et toutes les deux activent le 
support des sessions. Vous pourrez verifier que I'identifiant de session est 
bien transmis d'une page a l'autre et un cookie cree (cookie dont le detail du 
contenu est observable via l'interface ad hoc proposee par votre navigateur). 



Et dans PHP Saloon ? 

Notre exemple est effectivement tres simple, mais PHP Saloon reposera sur les memes 
mecanismes. II nous faudra maintenir la session entre la page listant les connectes, celle lis- 
tant les amis et enfin celle permettant de lire les messages recus. 
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Cookie Manager 



View and remove cookies that are stored on your computer. 



Site 


Cookie Name 


110 128 0 251 


PHPSESSID 


chat.ru 


Chat 


stat.onestat.com 


161898 


stat.onestat.com 


ONESTAT 


texturizer.net 


style 


www.texturizer.net 


style-Zfirebird/ 



Information about the selected Cookie 
Name: PHPSESSID 
Content: 34b266 e 5 e7297 e65 af co" af c5 da7f d46f 
Host: 10.128.0.231 
Path: / 
Server Secure: no 

Expires: at end of session 

Policy: no policy about storing identifiable information 



Remove Cookie 



Remove All Cookies 



P Don't allow sites that set removed cookies to set future cookies 

Cancel 



OK 



Figure 5-4 Visualisation du cookie via I'interface du navigateur 



Cette transmission sera encore plus evidente apres avoir desactive - pour 
quelques instants - le support des cookies dans votre navigateur. PHP ajoute 
de maniere transparente une variable supplemental aux liens vers p2.php. 



Source of: http ://!□. 128 .□ .25 l/bookfl]5/trans_sid/pl.php - M0ZU1...HE1D 



File Edit View 

lil ml 

<heaii> 

<title>Page K/title> 
<head> 
<foody> 

<p> Nous avon3 obtenu notre identifiant de session : 
4c4458bllab6d8b8b044133 21d57faf9 </p> 

<ul> 
<Xi><a 

href = ,r p2; . phJv?PHPSESSID = 4c4458bl lab 6d8b8b044 1832 ld57f af 9">Lien 
vers la page 2</a></li> 

</ul> 

/body: 
/html: 



Figure 5-5 
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B.A.-BA Contrdler les cookies dans son navigateur 

Chaque navigateur dispose de sa propre interface pour gerer les coo- 
kies. Voici celles disponibles sous Microsoft Internet Explorer et sous 
Mozilla (ou Netscape). 

Avec Microsoft Internet Explorer 

Toutes les options de configuration d'lnternet Explorer sont accessi- 
bles a partir du menu Outils, sous-menu Options Internet 
A partir de I'onglet General, il est possible d'effacer la totalite des 
cookies stockes et meme d'acceder au repertoire de stockage (via le 
bouton Parametres) Q. 



La configuration de la politique de securite appliquee au cookie est 
accessible via I'onglet Confidentiality Q. 

II est alors possible de choisir un niveau pre-etabli ou de preciser de 
maniere plus radicale ses choix (bouton Avance) ©. 



et Explorer 



irons Outils ? 

ft | ^ Courrier etNews 

Synchroniser... 
Windows Update 



Afficherles liens apparentes 
Console Java (Sun) 



Options Internet 



ma 



General | Sccuric | Ccnhocntioilc | Contcnu | Conncxwro | Progionmws | Avoncc | 
Page de demurrage 

|~^^ Voir prarve? cftoNi U |W)f a iibte« nvrtm? rwjp rt* (V*rwtAnjf> 
Adrette | about Wanl 



Paoa jctueto 



PaOfl P« del aui 



Paqe vierae 



Fichieft Internet tempoia«et 

V. Let p«gei Web cfje vout contultei tont ttocV eet dam un dotitet pout 
Y un affichage ulreneur phis laptde 

j Supprimer lei cooViei . | Suppiimer let tich»eri | Parametrei. 
Hitltxtque 

^ Le doniei Hutorique conbent lei ken: veil lei page: que vck.ii avei 
recemmert aflichees. afri cTy acc^der rapidemenf. 



|j0 ,,Arw m «**norr * 

Languei AccettWite 



Jourt pendant letquelt cei 
pages sort conservees : 

Couleuu . Pohce: 



Options Internet 



General | Sceuritc Confidenhalte | Contcnu | Conncworw | Progtonvnca j Avoncc | 



Ueplacez le cuseur aim ote setectionoei un parametre de 
<%S}> conlidcnlioitc poui lo cone Internet. 



Moyenne 

- Rlnrji* b« rnnlciM hmt qii n'nnt fuvt rV tlr*l*»ny nV 
confident tail e compoctc 

- Rlnnji* I* rnnkim hWt irtAtml rVs rfntrrMlim* 
dVfentitaation personnele sons voire conientement 

- Rp^rpinl I** rnnfc w»t mtofim qui liAtml iVt rinrrrWmnt 
iTuer 'iIj. atiun iUMide -on. vutie uufivctileiiierit 



Irrpottei | Avance 



Pour templacer la oemon des cookies pour les sites 
Web ndrvidueic, clique: sur le bouton Modhat. 



- 



Modta 



Farametres de confidentialite avances 



EVoue pouvez choicir Is manete dont tee cookies cent 
dam cette zone Internet Ceci remplace la gesbon 



atitomatique det cookies 



Cookies 

P lgno(cik)C}C3tK)noutomolJCfucdc3COok»c3 



Lookies internes 
t* Accepter 
• Rekiiw 
f DtiiiiarrJei 



Lookies berce parte 

Accepter 
f Refuse) 

Deiiiaridei 



_ 



f~ Tuujuuisdirtuiisci les tuukres dc la scsswri 




| Annulet | 
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Avec Mozilla et Netscape 

Toutes les preferences de Mozilla sont accessibles depuis le menu 
Edition, sous-menu Preferences Q. 

La gestion des cookies est traitee dans la section Securite. II est pos- 
sible de determiner simplement le refus ou non des cookies, de I'affi- 



ner eventuellement pour certains sites, voire, comme pour Internet 
Explorer, de definir des politiques par zone et niveau de securite Q. 
Enfin, Mozilla offre la possibility d'explorer efficacement le contenu 
des cookies et de supprimer selectivement certains d'entre eux Q. 



Uudu 


CuHZ 


Ruin 




Cut 


cm*x 


Copy 




Paste 


CtrH-V 


E«ut« 


Del 


All 


Clit+A 


PmdmThis Pag* 


CtrHP 


Find Again 


ObHO 


1-indPitviou* 


CUW-Shrrt-Kj 


FindLnlu A^VoiT- 




FwdTeilAiYouTyj 






1 PtaferencM . 



Done 



3 ^..S^rctl i -r | 



Ui-a" 



Cookie Manager 



3tuiedCuufcies | Cookie Sites | 
View and remove cookies thai ore stored ©nyoui computet 



Site | Cookie K>« 




Ul 


3itc3tnt ncd3tn1.nl si 


Information nhmilthit sHartMCnnfci* 







Han*, xd 

Content 9JMtn34 M 5*&i46363rdlBU 
Host www cyiutles turn 

r«ih / 

Serrci Secure uu 

ExpllCS )| end 

Policy no policy about stoiuig identifiable information 
Rwnnv«Oonlri« I Remove All (Tonkins I 



|~ Don't allow sites that set removed cookies to set future cookies 




Help 



3 Appear mice 

Cunipuser 
3 Mail & Newsgroups 

|^ 

Popup Windows 
Forms 
Passwords 
Enigmoil 

M aster P as swords 

Certificates 

Validation 
; ChalZilh 
< Advanced 
I Calendar 
Theme Installer 



Cookies are small pieces of information that some web sites ask to store on (and later 
retneve from) your computer. 

f» Disable cookies 

( ' Enable coohee tot the originating web cite only 
C Enable cuukies based uu privacy sellings 
C Enable all cookies 



17 Disable 



l>lc luiAics aiM*nl& Hewsgiuups 
P AsXmt utfutc storing a tuuku 

i lifetime of tuubes lu 
£ current session 

days 



ManageStoredCook.es 
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Et dans PHP Saloon ? 



Pour PHP Saloon, la solution retenue consiste a : 

• activer explicitement les sessions avec 
session_start() ; 

• utiliser directement le tableau _SESSI0N. 

Ces options permettent de ne pas avoir a modifier 
la configuration de PHP, configuration qui n'est 
pas toujours accessible, notamment dans le cas 
d'hebergements mutualises. 



Sauvegarde des donnees de session 

L'instruction session_start() permet done d'activer le suivi des visiteurs. 
Cependant, pour le moment, hormis l'identifiant, le profil d'un visiteur ne 
comporte encore aucune donnee. Pour resoudre ce manque, PHP permet 
d'associer certaines donnees a la session. Celles-ci seront alors preservees 
pendant toute la duree de vie de la session. 

Pour ce faire, PHP met a notre disposition le tableau superglobal _SESSI0N. 
Ce tableau, en permanence accessible, est automatiquement initialise avec 
les donnees de session. De meme, chaque element ajoute a ce tableau sera 
automatiquement ajoute aux donnees de la session. 

A titre d'experimentation, nous allons reprendre notre site elementaire, tou- 
jours constitue des deux pages pl.php et p2.php. Dans la premiere page, nous 
allons associer une variable a la session avant de constater si celle-ci est bien 
conservee dans la deuxieme page. La plupart des sites disposant de sessions 
reposent sur ce meme mecanisme. 

pl.php 

<? session_start() ; ?> 

<html> 

<head> 

<title>Page l</title> 
<head> 
<body> 

<p> Nous avons obtenu notre identifiant de session : 
<? print session_id() ; ?><br/> 
Et enregistre la variable phpsaloon qui prend la 
valeur 3. 

<? $_SESSI0N[ 'phpsaloon'] = 3; ?> 

</p> 
<ul> 

<lixa href="p2.php">Lien vers la page 2</ax/li> 
</ul> 
</body> 
</html> 



p2.php 

<? session_start() ; ?> 

<html> 

<head> 

<title>Page 2</title> 
<head> 
<body> 
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at 
i/i 

<p>Cette page est juste une page de test!</p> J> 

<p>L'identifiant de session qui nous a ete 

attribue est conserve : <? print session_id() ; ?></br> 

Et mieux, le contenu de la variable phpsaloon aussi (il 

s'agit de : <? print $_SESSI0N [ 'phpsaloon '] ; ?>) . 

</p> 
</body> 
</html> 



Page 2 - Mozilla Firebird 



File Edit View Go Bookmarks Tools Help 



s?' " jj) | http://10 12S.0.231ftoo_*J 



Cette page est juste une page de test! 

L'identifiant de session qui nous a ete attribue est 
conserve : 34b266e5e7297e65afc]Safc5da7fd46f 
Et mieux, le contenu de la variable phpsaloon aussi (il 
s'agit de : 3). 

Done 



Figure 5-6 

Persistance du tableau _SESSION 
au sein d'une session 



ALTERNATIVE session_register() 

Au lieu de manipuler directement le tableau _SESSI0N , il est possible de travailler sur ses 
propres variables. 

L'instruction session_register() permet de designer les variables qui constituent le 
profil du visiteur et qui doivent, a ce titre, etre preservees d'une page a I'autre. 
Avec I'appel a session_register() , PHP gere automatiquement la sauvegarde des 
variables designees et leur restauration des I'utilisation de session_start(). 
L'utilisation de session_register() peut done paraTtre plus simple, cependant les pie- 
ges sont nombreux. Tout d'abord, I'apparente simplification qui resulte de l'utilisation des 
variables courantes aboutit en realite a un code difficile a interpreter. En effet, sauf si vous 
utilisez une charte de nommage tres stride, rien ne distingue une variable classique d'une 
variable dont la valeur sera preservee durant la session. 

Par ailleurs, la restauration automatique des variables est subordonnee a I'activation auto- 
matique de I'option registrer_global s dans le fichier de configuration PHP. Une option, 
qui permet aussi la creation automatique de variables a partir des parametres de I'adresse 
web ou des formulaires, est desormais desactivee par defaut, compte tenu des risques 
d'utilisations malicieuses des pages developpees. 

Enfin, l'utilisation simultanee du tableau _SESSI0N et de session_register() est 
impossible (soit PHP gere ce tableau, soit le developpeur y accede, mais jamais les deux). 
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Premiere implantation de la classe session 



Au chapitre 2, nous avons defini l'interface a respecter : 

<? 

interface iSession { 
function updated 
function active() ; 

} 

?> 

Nous allons done creer la classe session en conformite avec cette interface en 
prevoyant : 

• un constructeur ; 

• les deux fonctions updateO et active(). 

La date de derniere mise a jour sera stockee dans le tableau _SESSI0N. Cette 
premiere implantation est particulierement simple : 

<? 

requi re_once 'isession.php' ; 
class session implements iSession { 
static private $db; 
static private Sgestionnai re; 

function construct($timeout = 120) { 

$thi s->timeout = Stimeout; 
session_start() ; 

} 

function updateO { 

$_SESSI0N[ 'maj'1 = time() ; 

} 

function active() { 

if ( (time() - $_SESSI0N[ 'maj ']) > $thi s->timeout) 

return false; 
return true; 

} 

} 

?> 

Notre classe session peut alors etre utilisee dans tous les fichiers pour verifier 
l'existence d'une session active : 

<? 

requi re_once ' session. php' '; 

Ssession = new session(320) ; 
if ($session->acti ve()) 
$session->update() ; 

else { 



at 
i/i 

// reagi r car la session n'existe pas ou a expire. m 

die("I7 faut reagirl"); 
} 

?> 

<htm~l> 

<headxtitle>Page protegee</titlex/head> 
<body> 

Vous voyez cette page car votre session 

est active! Hourra! 

</body> 

</htm1> 



REGARD DU DEVELOPPEUR Cookies et date d'expiration 

Chaque cookie dispose d'une date d'expiration, il peut done paraTtre etrange de gerer 
nous-memes I'expiration quand il serait tellement simple de laisser le cookie expirer tout 
seul. Ceci d'autant que PHP permet d'agir sur la date d'expiration avec la fonction : 
sessi on_set_cooki e_params () . 

Helas, le diable se retrouve, comme souvent, dans les details. En effet, il appartient au ser- 
veur de transmettre la date d'expiration. Cette date est calculee et determinee en fonction 
de la date du serveur lui-meme. Or, les ordinateurs sont rarement totalement synchrones, et 
le plus souvent I'ordinateur du visiteur et le serveur ne sont tout simplement pas exacte- 
ment a I'heure. L'expiration devient alors un jeu aleatoire, d'autant que certains naviga- 
teurs vont voir d'un mauvais ceil les dates d'expiration dans le passe. 
La solution retenue consiste a utiliser un cookie de session. Ce type de cookie ne precise 
pas de date d'expiration et le navigateur va les traiter specifiquement. De tels cookies res- 
teront valides tant que le navigateur est ouvert et seront detruits a la fermeture de celui-ci. 
Cette situation nous convient parfaitement, meme s'il faut en contrepartie gerer nous- 
memes le cas des utilisateurs qui laissent leur navigateur ouvert inactif. 



Pilote de sauvegarde pour les sessions 

Toutefois, cette premiere implantation fonctionnelle pose deux problemes : 

• la securite ; 

• le couplage avec notre modele de donnees. 

La securite tout d'abord. En effet, par defaut, les donnees de session sont 
sauvegardees par PHP dans un fichier. II existe un seul fichier par session et 
tous les fichiers se trouvent dans le meme repertoire. Ce procede appelle 
plusieurs reflexions : 

1 Les fichiers sont stockes dans un repertoire accessible a tous (notamment 
dans le cas d'un systeme Unix) et au mieux dans un repertoire accessible a 
l'utilisateur pour le serveur web. 
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CONFIGURATION Chemin de sauvegarde 
pour les donnees de session 

Par defaut, sous Unix, le chemin de sauvegarde est 
/tmp, le repertoire temporaire traditionnel. II est 
possible de modifier ce chemin en utilisant la 
directive : session. save_path = "/tmp". 
ou encore la fonction session_save_path(). 
Changer le chemin peut ameliorer la securite des 
donnees stockees quand le serveur n'est pas 
mutualise. 



2 Toutes les sessions sont stockees au mime endroit, done en cas d'heber- 
gement mutualise et si rien n'est fait, les donnees des differents clients 
sont melangees. 

3 Avec ce melange, un client mal intentionne de l'hebergeur peut acceder 
aux donnees des autres clients. 

Par chance, PHP permet de remplacer ce mecanisme par celui de son choix. 
La methode peut paraitre complexe de prime abord mais il n'en est rien. 
Pour sauvegarder les donnees de session, PHP fait necessairement appel a 
quatre fonctions principales : 

• une fonction chargee d'ouvrir le media (par defaut un fichier) dans lequel 
les donnees seront stockees ; 

• une fonction chargee de lire les donnees dans le media ; 

• une fonction chargee d'ecrire les donnees ; 

• une fonction chargee de terminer Faeces au media. 
A ceci, s'ajoutent deux fonctions utilitaires : 

• une fonction appelee pour detruire une session ; 

• une fonction jouant le role de garbage collector (cette derniere fera l'objet 
d'une explication specifique). 

Ce sont ces fonctions que PHP nous permet de remplacer avec l'instruction 
session_set_save_handler(). Dans PHP Saloon, nous disposons deja d'un 
media bien adapte : notre base de donnees SQLite ! 



B.A.-BA Handle, callback, handler & hook 

Ces mots sont tres souvent utilises lorsqu'il s'agit de transmettre des fonctions en parame- 
tre ou de manipuler des donnees dont le contenu nous est cache (donnees opaques). Leur 
traduction en francais est plutot hasardeuse et ne constitue pas vraiment un facteur de lisi- 
bilite. 

Le terme handler designe le plus souvent une fonction, un objet qui joue un role de gestion- 
naire pour un type de donnees ou une situation. On parlera de string handler par exemple et 
dans notre cas de save handler. 

Lorsque le handler est destine a modifier ou a remplacer un element interne a un logiciel, 
on parle de hook (crochet). II existe des hooks permettant d'etendre le moteur PHP ou le 
noyau GNU/Linux, par exemple. 

Une callback est une fonction, comme peut I'etre un handler mais il s'agit en general d'une 
fonction qui sera declenchee de maniere asynchrone dans une logique evenementielle. Les 
callbacks sont tres presentes quand on parle d'interface graphique. On definit ainsi des call- 
backs pour les boutons, celles-ci seront appelees si Ton clique dessus. 
Enfin, le handle (poignee) designe une bribe d'information permettant d'acceder a I'infor- 
mation principale. Ainsi, dans PHP 5, on ne manipule plus les objects directement mais un 
object handle (en fait, le numero de serie de l'objet dans la base des objets existants). 
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<V 

Pilote de session SQLite pour PHP Saloon J, 

II nous faut done creer six fonctions et modifier le constructeur de notre 
classe session afin d'activer notre mecanisme de sauvegarde. 

Comme nous avons pris le parti d'utiliser les nouvelles fonctionnalites objet 
de PHP, nous allons reunir ces quatre fonctions au sein d'une meme classe 
qui devra valider l'interface suivante : 

<? 

interface iCestionnai reSession { 
static function open(); 
static function close(); 
static function read(Scle); 
static function write($cle, Svaleur); 
static function destroy ($cle) ; 
static function gc($duree); 

} 

?> 

L'ensemble des fonctions sont declarees statiques car en realite nous n'ins- 
tancierons pas d'objet et le changement de gestionnaire de session sera rea- 
lise par la fonction acti ver(). 

La table sessions 

Avant d'activer ce gestionnaire, il convient de nous assurer que la base de 
donnees comporte bien une table pour le stockage. 

Cette table est simple, nous l'avons deja decrite dans le chapitre precedent ; 
elle ne comporte que deux colonnes, une pour l'identifiant de session, une 
pour les donnees. 



sessions 



sessionjd varchar(32) <pk> 
data text 



Figure 5-7 

Structure de la table sessi ons 



Les fonctions du gestionnaire de session interrogeront cette table pour y lire 
ou y mettre a jour les donnees de session. 



101 



La classe gestionnaireSession 



METHODE Deboguer les 
gestionnaires de session 

Les fonctions d'un gestionnaire de session peuvent 
etre appelees hors du contexte des scripts PHP 
(par exemple apres son execution) ; de fait, le 
debogage est parfois complexe. L'affichage de 
messages d'informations est le plus souvent ineffi- 
cace, car la page est deja creee au moment oil 
l'affichage est demande. 

Pour suivre plus efficacement le fonctionnement 
d'un gestionnaire, une solution possible est 
d'ecrire les messages de debogage dans un fichier, 
par exemple avec la fonction errorlogQ. 



Le code de la classe session est relativement simple. Dans cette premiere 
version, nous laisserons de cote l'aspect nettoyage en proposant une fonction 
garbageCollector() vide. 

<? 

requi re_once ' i gesti onnai resessi on . php '; 
class gesti onnai reSqlite implements iCestionnai reSession { 
static private $db; 
static private Sactif; 
static function open() { 

if (gestionnai reSqlite: :$db = new sqlite_db( 'test')) 

return true; 
return false; 

} 

static function closeO { 
// laissons PHP tout fermer 
return true; 

} 

static function read(Scle) { 

return gestionnai reSqlite: :$db->single_query("se7ect data from 
sessions where session_id = '5c7e'"); 
} 

static function write($cle, Svaleur) { 

if (! @gesti onnai reSql i te : : $db->query( "Ynsert into sessions 
values C'Scle', ".time().", 'Svaleur')")) { 

if (gestionnai reSqlite: : $db->query( "update sessions set data = 
'Svaleur' where session_id = 'Scle'")) 
return true; 
return false; 

} 

return true; 

} 

static function destroy(Scle) { 

if (gestionnai reSqlite: :$db->query("de7ete from sessions where 
sessions_id = 'Scle'")) 
return true; 
return false; 

} 

static function gc($duree) { 
return true; 

} 
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at 
i/i 

static functionactiverO { m 
if (! gestionnaireSqlite: :$actif) { 

session_set_save_hancner(array( 'gestionnaireSqlite ' , 'open ') , 
array( 'gestionnaireSqlite ' , 'close ') , 
array( 'gestionnaireSqlite ' , 'read') , 
array( 'gestionnaireSqlite' , 'write'), 
array( 'gestionnaireSqlite' , 'destroy') , 
array( ' gestionnai reSqlite ' , 'gc')); 
gestionnaireSqlite: :$actif = true; 

} 

} 

} 

?> 



SYNTAXE Acces a des attributs et methodes statiques 

PHP adopte parfois une syntaxe etrange, ainsi I'acces a un attribut statique se fait selon la 
syntaxe suivante : 

classe: :$attribut 

et non : 

Sclasse: : attribut 

Ce qui est plutot logique en realite. 

Moins logique, une methode statique ne peut etre designee par son nom sous la forme : 
classe: :fonction 

Au contraire, il est necessaire de construire un tableau, le premier element designant la 
classe, le second le nom de la methode. 

array( 'classe', 'methode') 

A noter que cette syntaxe s'etend aux methodes objet. Dans ce cas, le premier element du 
tableau est I'objet lui-meme. 

II faut noter que le gestionnaire de session utilisera sa propre connexion a la 
base. En effet, les fonctions du gestionnaire peuvent etre appelees alors 
meme que l'execution du script PHP est terminee, en particulier les fonc- 
tions d'ecriture et de cloture. II est done impossible d'utiliser une connexion 
partagee par tout le script et qui pourrait etre close par megarde avant les 
derniers appels au gestionnaire. 

Garbage collector 

Dans l'implantation precedente, nous avons laisse de cote l'aspect nettoyage. 
Ce role est tenu par la fonction garbageCollectorO, ramasse-miettes en 
francais. 
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Pourquoi faire le menage dans nos sessions ? Tout simplement pour eviter 
l'accumulation de sessions qui ont expire et sont done inutiles. Une option 
possible pour notre fonction garbageCollector() peut etre de les effacer sans 
distinction. 

II va de soi que cette fonction ne doit pas etre appelee pour chaque script 
PHP execute ! PHP permet done de definir une probabilite d'appel. 



CONFIGURATION L'appel du garbage collector du gestionnaire de session 

La probabilite d'appel est definie dans le fichier de configuration PHP avec la directive : 
session. gc_probabilility = 1 

Cette directive precise le pourcentage des scripts PHP qui verront la fonction de 
garbageCollectorO appelee. Par defaut, il s'agit de 1 . 

Enfin, PHP permet de preciser un delai de peremption (par defaut 1440 secondes). Ce delai 
est passe en parametre a la fonction de nettoyage et est configurable avec la directive : 

session_gc_maxl ifetime = 1440 

Dans le cas de PHP Saloon, ce delai est ignore au profit du delai d'expiration fixe pour les 
sessions. 



Implantation retenue 

Avec notre gestionnaire de session, nous pouvons ameliorer notre classe 
session pour aboutir a un code plus satisfaisant. 



requi re_once 'gestionnai resqlite.php '; 
requi re_once 'unserialize.php '; 
requi re_once 'isession.php'; 
class session implements iSession { 
function construct(Stimeout) { 

$thi s->timeout = Stimeout; 

gestionnai reSql ite: :activer() ; 

session_start() ; 

} 

function update() { 

$_SESSI0N[ 'maj'1 = time() ; 

} 

function active() { 

if ( (timeO - $_SESSI0N [ 'maj '] ) > $thi s->timeout) 

return false; 
return true; 

} 
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static function getSessionData($data, $nom) { 
$a = unseria~lize_session($data) ; 
return $a[$nom] ; 

} 

} 

?> 

Cette nouvelle classe session sauvegarde les donnees dans la base de donnees 
SQLite utilisee pour tout PHP Saloon. II va done nous etre possible de tirer 
directement profit des donnees de session dans nos futures requetes SQL. 

Decodage des donnees de session 

Helas, la encore, le diable se retrouve dans les details. En effet, pour sauve- 
garder les donnees de session (en realite le tableau _SESSI0N), PHP realise 
une operation de serialisation. Cette operation consiste a transformer un 
objet stocke en memoire (ici, notre tableau _SESSI0N) en une chaine de 
caracteres facile a sauvegarder. Une operation inverse (deserialisation) 
permet de recreer l'objet en memoire a partir de la chaine de caracteres. 

Cet encodage en un seul agregat de donnees est souvent penible a gerer, sur- 
tout si Ton dispose en parallele d'un modele de donnees complet. Pour PHP 
Saloon, les choses restent relativement simples, notre profil de session ne 
comportera que deux informations dont la date de mise a jour. 

Cependant, dans la plupart des cas, et notamment dans les applications de 
commerce electronique, ce stockage en retrait du modele de donnees est tout 
simplement impensable. Aussi, nombre de services se contenteront de Con- 
ner a PHP la gestion de l'identifiant et des cookies et realiseront eux-memes 
le stockage de chaque element manipule avec des requetes dans la base de 
donnees. 

Par ailleurs, si PHP dispose de deux fonctions : serializeO et unseria"lize() 
qui fonctionnent sur toutes les donnees manipulees dans PHP, celles-ci ne 
sont pas celles utilisees pour encoder les donnees de session. Pire, la fonction 
de decodage necessaire n'est pas disponible en standard dans PHP. 

II va done falloir user d'un peu de sorcellerie et surtout expliquer une fonc- 
tion PHP specifique presentee en annexe : unserialize_session() . Celle-ci 
servira a decoder les donnees stockees dans notre table sessions et va nous 
permettre d'ajouter une fonction d'acces aux donnees de session dans notre 
classe session : 

<? 

static function getSessionData($data, $nom) { 
$a = unserial ize_session($data) ; 
return $a[$nom] ; 

} 

?> 



ATTENTION session decodeQ 

La fonction session_encode retourne bien 
une chaine de caracteres representant le con- 
tenu du tableau _SESSI0N, mais malheureuse- 
ment la fonction session_decode() ne 
retourne pas assez logiquement un objet PHP 
mais modifie directement le tableau _SESSI0N. 
Impossible done, par exemple, de consulter les 
donnees de la table sessions de notre base 
SQLite sans demolir le tableau _SESSI0N 
courant ! 



105 



La fonction getSessionData() est declaree statique car elle ne depend pas 
d'un objet mais est utilisable sans contrainte particuliere. Nous l'utiliserons 
notamment dans les requetes SQLite. 



function unserial ize_session($va~l) 
{ 

// traiter le cas des pipes dans les chaines 

$val = preg_replace( '/"([A"]*)";/e' , '\ "'\ '. urlencode("$l") . 
\"';\",$val); 
// separer nom et valeur 

$tmp = preg_sp"lit( V([ A ;}] [A-Za-z0-9_]+)\l/' , $va"l , -1, 
PRE(LSPLlT_DELIM_CAPTURE) ; 
// reconstruire le tableau 
for(array_shift($tmp) ; 

$nom = array _shi ft ($tmp) ; 

$resu~lt[$nom] = unserialize(urldecode(array_shift($tmp)))) ; 
return Sresult; 
} 

?> 



COMPRENDRE Le codage des donnees de session 

Nous I'avons vu, PHP encode les donnees de session de maniere privee (il est toutefois pos- 
sible d'opter pour le format WDDX sous reserve de disposer de I'extension). 
Ainsi, pour un tableau de deux elements : 

array( 'premier' => 2, 'deuxieme' => "foo") 

PHP encode comme suit : 

premier | i :2 ;deuxi eme| s: 3: "foo" ; 

Ce codage simple d'apparence necessite un peu d'effort en cas de donnees plus complexes. 
Voici done un peu de magie avec la fonction unserialize_session() (voir ci-dessus). 
Celle-ci realise ce travail au mieux, sans toutefois etre parfaite. Elle est suffisante pour PHP 
Saloon. 



Extension de la classe session 

La classe session creee precedemment est suffisante. Pour eviter neanmoins 
de repeter sur chaque page le mecanisme de test de validite et le traitement 
en cas d'expiration, il peut etre judicieux d'etendre la classe session en defi- 
nissant une nouvelle classe : sessionValide. 
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Les objets ainsi definis imposeront la presence d'une session valide, ou pro- 
voqueront la redirection vers la page d'identification. 

<? 

requi re_once 'session. php '; 

class sessionVal ide extends session { 

function construct($redi rection, Sframe = false ) { 

parent: : construct(120) ; 

if ($this->active()) { 

$this->update() ; 
} else { 

if (! Sframe) 

header( 'Location: ' . Sredi rection) ; 
else 

print «<E0F <html> 
<headxti tl e>Redi recti on ! </ti tl ex/head> 
<script> 

wi ndow. parent. location = "Sredi rection" ; 
</scri pt> 
<body> 

Vous devriez etre redirige(e) automatiquement. Si ce n'est pas le 
cas, <a href="Sredi rection">cliquez-ici</a>. 
</body> 
</html> 

EOF; exit(); 
} 

} 

} 

?> 

Cette nouvelle classe prend en compte la redirection, meme quand l'expira- 
tion se produit au sein d'un frame ; c'est alors la totalite du document parent 
qui est rechargee. 



En resume... 

PHP offre une multitude de fonctionnalites pour gerer les sessions. Cer- 
taines permettent de disposer de sessions de maniere presque totalement 
transparente. Cependant, comme nous venons de le constater, il est parfois 
plus sage de mettre les mains dans le cambouis et de savoir avec precision ce 
qu'il en est des donnees manipulees pour pouvoir en faire le meilleur usage. 

Pour PHP Saloon, nous venons d'adopter une position mediane en confiant 
a PHP la gestion des aspects les plus ardus (comme les cookies ou la creation 
de l'identifiant de session) tout en conservant le controle sur le stockage des 
donnees. 



chapitre 
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Fatal error: Uncaught exception 'sqlite_exception' with message 'sqlite_db::sqlite_db() 
r function sqlite-db l: unable to open database: /var/www/v2/ex/foo' in 
/var/www/v2/ex/06-testl.php:4 Stack trace: #0 /var/www/v2/ex/06-testl.php(9): 
foo('foo') #1 /var/www/v2/ex/06-testl.php(12): barO #2 {main} thrown in 
var/www v2 ex 06-testl.php online 4 



Gerer les erreurs 
grace aux exceptions 



Jusqu'a cette nouvelle version, PHP est reste tres 
conventionnel dans la gestion des erreurs. 
Or, nous verrons que le nouveau systeme 
d'exceptions de PHP 5 peut apporter 
une amelioration sensible de la qualite 
des developpements. Pour autant, la gestion 
historique des erreurs ne doit pas disparaitre. 
Tout est question d'equilibre. 
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Le traitement classique des erreurs dans 
PHP Saloon 



PHP 4 Objet ou pas, le traitement des 
erreurs reste une priorite 

Dans PHP 4, aucun choix possible ; seul le traite- 
ment classique des erreurs est disponible et il 
demeure imperatif pour assurer a I'utilisateur la 
meilleure qualite de service possible, mais aussi 
pour proteger les donnees manipulees. 



Dans un programme, chaque appel de fonction ou presque, est susceptible 
d'echouer, parce que des parametres incorrects sont mis en jeu ou simple- 
ment parce que l'environnement d'execution n'est pas celui escompte. 

Un principe elementaire 

Le traitement classique de la situation s'articule en deux temps : 

• tester a chaque etape la reussite de Taction a mener ; 

• en cas d'echec, retourner un code d'erreur. 

Ce modele de fonctionnement est particulierement simple. Cette simplicite con- 
ceptuelle est pourtant a l'origine de l'inconvenient majeur qui penalise cette 
methode. Dans la pratique, il vous faudra effectuer des dizaines de tests qui com- 
plexifient le code developpe, sans parler des codes d'erreurs et de leurs messages 
associes qui doivent cheminer entre les appels de fonctions pour etre exploitables. 

Considerons la classe utilisateur decrite au chapitre 4. Sa methode 
connecteO illustre parfaitement cette maniere de faire : 

class utilisateur { 
// ... 

function connecte(Sdb) { 

// $db est une connexion deja ouverte vers la base SQLite 
Sid = $db->single_query("select id from utilisateurs 
where pseudo = ' {$thi s->pseudo} ' and 
motdepasse= ' {$thi s->motdepasse} ' ") ; 
if (Sid) { 

Ssession = new session(120) ; 
$_SESSION['uid'] = Sid; 
$session->update() ; 
return true; 

} 

return false; 

} 

// ... 

} 

Un test est realise pour s'assurer que la requete s'est correctement deroulee. En 
fonction du resultat, un code de retour est renvoye comme resultat de l'appel a 
connecte(). Tout devrait done etre pour le mieux. Mais il n'en est rien. 

Une realite plus complexe 

Premiere erreur, la signification de la valeur $i d est biaisee. Rien ne permet, a pre- 
miere vue, de distinguer lechec de la requete, par exemple si le code SQL est incor- 
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rect, d'un identifiant qui vaudrait zero. Certes, on suppose dans ce cas que iidenti- 
fiant d'un utilisateur nest jamais nul, mais dans la pratique, qui pourrait le jurer ? 

II faut done examiner de plus pres le fonctionnement de la methode 
single_query() dans cinq situations precises : 

• La requete est erronee. 

• La requete est valide mais aucune ligne ne correspond. 

• La requete est valide, une ligne correspond et la valeur est 0. 

• La requete est valide, une ligne correspond et la valeur est non nulle. 

• La requete est valide, plusieurs lignes correspondent. 

Nous le voyons d'emblee, d'une situation apparemment elementaire, on bas- 
cule dans la gestion de cas multiples et parfois complexes dans leurs implica- 
tions. La documentation de la classe sqlite_db nous permet de construire le 
tableau suivant : 
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Requete erronee 


Pas de resultat 


Resultat unique nul Resultat unique 


Resultat multiple 


Valeur de retour 


Bool(false) 


NULL 


String(1) "0" 


String 


ArrayO 


Evalue a false avec == 


</ 


✓ 


✓ 






A exclure 


•/ 


✓ 






✓ 



Si Ton n'y prend pas garde, ce sont done seulement trois cas sur cinq qui sont 
evalues comme equivalents au booleen f al se, et pas forcement ceux a exclure. 

La simple comparaison realisee dans notre code, comme d'ailleurs, l'utilisa- 
tion de l'operateur de comparaison usuel == ne suffit pas. PHP dispose par 
chance de l'operateur ===. Contrairement a l'operateur classique == la com- 
paraison va porter aussi sur le type de la donnee, telle que stockee dans 
l'interpreteur PHP. 

Nous pouvons done modifier notre methode de la facon suivante : 

class utilisateur { 
// ... 

function connecte(Sdb) { 

// $db est une connexion deja ouverte vers la base SQLite 
Sid = $db->single_query("select id from utilisateurs 

where pseudo = '{$this->pseudo}' and 

motdepasse= ' {$this->motdepasse} "') ; 
if ( (Sid === false) || (Sid === NULL) || is_array($id) ) 

return false; 
Ssession = new session(120) ; 
$_SESSI0N['uid'] = Sid; 
$session->update() ; 
return true; 

} 

// ... 

} 



COMPRENDRE La comparaison 
dans les langages peu types 



Le comportement de l'operateur == peut paraTtre 
bien etrange dans la situation presentee. Mais il 
s'agit en realite du fonctionnement classique 
adopte dans I'ensemble des langages non types et 
meme, dans une moindre mesure, en C. 
Cette approche permissive qui veut que globale- 
ment tous les elements neutres des types de don- 
nees soient evalues a false, est le plus souvent 
simplificatrice. 

Le revers est alors de ne pas detecter les situations 
pour lesquelles cette version etendue de la compa- 
raison biaise le comportement attendu. 
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Cette version n'assure encore qu'une prise en compte partielle des erreurs. 

II faudrait probablement retourner une valeur distincte de false pour distin- 
guer les erreurs manifestes, soit dans le code SQL, soit dans la coherence de 
la base, du simple fait que l'utilisateur n'existe pas ou a donne un mot de 
passe errone. 

On pourrait choisir les codes de retour suivants (assez classiques au 
demeurant) : 

• -1 : erreur dans l'application ; 

• 0 : erreur dans les donnees utilisateur (login ou mot de passe) ; 

• 1 : utilisateur connecte. 

Soit une petite modification dans le code : 

class utilisateur { 
// ... 

function connecte(Sdb) { 

// $db est une connexion deja ouverte vers la base SQLite 
Sid = $db->single_query("select id from utilisateurs 
where pseudo = '{$this->pseudo}' and 
motdepasse= ' {$thi s->motdepasse} ' ") ; 
if ( (Sid === false) || is_array($id) ) 

return -1; 
if ($id === NULL) 

return false; 
Ssession = new session(120) ; 
$_SESSION['uid'] = Sid; 
$session->update() ; 
return true; 

} 

// ... 

} 

Dans la pratique, il reste encore un bon nombre d'erreurs qui ne sont pas 
prises en compte. Ainsi, la creation d'une nouvelle session pourrait echouer, 
comme sa mise a jour avec la methode updateO. 

Notre idee de depart, extremement simple, peut tres vite virer au cauchemar, 
avec le risque d'oublier ici et la des situations d'echec. 

Un risque additionnel pour les applications web 

Ce risque est d'autant plus grand que les applications web doivent tenir 
compte, et ce, avec la plus grande rigueur, d'une vulnerabilite classique mais 
bien plus dangereuse a l'echelle d'Internet : le cross site scripting ou XSS. 

PHP Saloon, comme la plupart des applications web dynamiques, interagit 
avec l'utilisateur, qui lui transmet des informations. Des lors, l'application 
manipule des contenus, stockes le plus souvent dans des variables (dans 



l'exemple precedent le mot de passe et le pseudo) dont la nature est par 
essence, incontrolable a priori. 

Le XSS consiste done a veroler le contenu de ces variables, directement via 
un formulaire, ou en modifiant les URL. Lidee est alors de placer du code 
malicieux en lieu et place des donnees attendues. 

Dans une application comme PHP Saloon, ce code malicieux peut revetir au 
moins deux formes : du code SQL, susceptible de corrompre, voire de 
detruire notre base de donnees, ou encore du code PHP qui accedera alors a 
la totalite des fonctionnalites offertes par PHP cote serveur. 

Reconsiderons notre requete, par exemple avec PHPFan comme pseudo et 
secret comme mot de passe. Dans ce cas, tout va pour le mieux, la requete 
executee est : 



select id from utilisateurs where pseudo 
motdepasse= 'secret' 



'PHPFan' and 



Que se passe-t-il si la valeur du mot de passe est desormais secret' ; delete 
from utilisateurs ? La requete executee secrit a present : 

select id from utilisateurs where pseudo = 'PHPFan' and 
motdepasse= 'secret'; delete from utilisateurs 

Faute de precautions suffisantes, nous venons de perdre l'integralite de nos 
utilisateurs. 

II convient done de modifier notre code pour ajouter les verifications indis- 
pensables, verifications qui peuvent aboutir a de nouvelles erreurs ou un rejet 
des donnees, d'ou un nouveau cycle dans le traitement des erreurs. 



ATTENTION Magic quotes 

PHP essaie le plus possible de fournir des auto- 
matismes pour eviter les incidents lies a I'inser- 
tion de code malicieux dans les variables. C'est 
notamment le cas des « Magic quotes ». Cette 
fonctionnalite, configurable dans le fichier 
php.ini, permet a PHP de resoudre le cas epi- 
neux des guillemets et de I'apostrophe, notam- 
ment pour les bases de donnees et les formulai- 
res web. 

Cependant, dans une tres large majorite de cas, 
ce traitement sympathique sera insuffisant et 
peut aller jusqu'a compliquer davantage le trai- 
tement de I'information. 
On peut alors desactiver ces transformations et 
faire appel a des fonctions plus puissantes : 

• htmlentitiesO ; 

• addslashesO I 

• escapeshellcmdQ. 
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Les exceptions, comme alternative 



La chasse aux erreurs risque de transformer rapidement ce qui devait etre 
une classe toute simple en un morceau de code spaghetti quasi indechif- 
frable. Pour eviter ce genre de derive, les exceptions vont mettre en ceuvre 
une tout autre philosophic 

Le concept 

Lidee principale est de detacher le code correspondant au fonctionnement 
normal, du code « exceptionnel » qui peut entrer en jeu de maniere ponc- 
tuelle pour considerer une situation particuliere, souvent une erreur. 



Syntaxe des exceptions en PHP 

try { 

// algorithme general 

} 

catch(PHPSaloon_Exception $e) { 
// situation exceptionnelle 1 

} 

catch(Exception $e) { 

// situation exceptionnelle 2 

} 
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Instruction 1 ; 
Instruction 2; 
,,. Instruction fautive; 

Instruction 4; //jamais execute 

v . catch (PHPSaloon_Exception $e) { 
Instruction 5; 

< catch (Exception $e) { 
Instruction 6; 

'< } 

I Instruction 7; 
Instruction 8; 

Figure 6-1 Interception d'une exception 
par un bloc try/catch 



Linteret de ce procede est de preserver le maximum de lisibilite en separant 
1'algorithme et le mecanisme mis en jeu, mais aussi les traitements concep- 
tuellement moins essentiels, independamment de leur necessite. 

La structure syntaxique adoptee dans PHP (et par la plupart des autres lan- 
gages) reprend cette separation avec d'une part un bloc try, devolu au cadre 
general, et un ou plusieurs blocs catch qui traiteront les cas exceptionnels. 

Le fonctionnement dans PHP 

Au-dela de ce decoupage, il reste a determiner les conditions du bascule- 
ment entre le cadre general (try) et les situations exceptionnelles (catch). 
Pour comprendre le fonctionnement adopte, on peut associer l'exception a la 
notion de signal. 

Au sein du bloc try, l'execution d'une instruction erronee va declencher 
l'emission d'un signal : notre exception. Ce signal va interrompre l'execution 
de tout le bloc. 

Ensuite, en fonction de la nature du signal, l'interpreteur PHP executera le 
bloc catch approprie. Dans cette hypothese, l'execution du bloc try n'est 
jamais terminee. 

Comme PHP 5 dispose d'un bon modele objet, l'implantation choisie pour 
les exceptions ne se resume pas a un simple signal, mais definit les excep- 
tions comme des objets de la classe exception ou de tout autre classe derivee. 

Le choix de la section catch appropriee est alors fonction de la classe de 
l'objet. A charge aux developpeurs de creer leurs propres classes d'excep- 
tions. 

Du point de vue pratique, l'interpreteur et les extensions PHP peuvent pro- 
voquer des exceptions, mais cela vaut aussi pour le code PHP lui-meme via 
l'instruction throw : 

| throw new PHPSa~loon_exception() ; 

Pour PHP Saloon, nous pouvons done definir notre propre classe exception. 
II n'est pas necessaire d'ajouter quoi que ce soit. Ce qui nous interesse ici est 
de pouvoir differencier nos exceptions de celles susceptibles d'etre declen- 
chees par ailleurs : 

class PHPSa~loon_Exception extends Exception { 

} 
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EN COULISSE Les proprietes de la classe exception 

La classe exception est imposee par PHP comme classe parente de toute classe utilisable 
avec catch. Cette classe est naturellement vouee a etre etendue sous forme de classes 
derivees. Celle-ci dispose en I'etat d'un certain nombre de methodes (les proprietes sont 
privees, ce qui est naturel) : 

• getMessage() ; 

• getCodeO ; 

• getl_ine() ; 

• getFileO ; 

• getTrace() ; 

• getTraceAsStringO. 

L'ensemble de ces methodes permet d'acceder a la totalite des informations des : message 
d'erreur, pile des fonctions appelees, localisation dans le code. 

Cette richesse permet de realiser, notamment pour le debogage, des affichages plus com- 
plets et plus utiles a la maniere de Java, ce que permet I'acces a la pile des appels (fonction 
getTraceQ). 



Cette definition nous permettra alors de traiter separement et au mieux les 
exceptions en fonction de leur origine, par exemple SQLite ou DOM (voir 
le chapitre suivant) : 

try { 
// ... 

$db = new sqlite_db('test') ; 
// ... 
if (! $x) { 
// ... 

throw new PHPSa~loon_Exception("Uti~lisateur inconnu"); 
} 

} 

catch (SQLite_Exception $e) { 

// pas recuperable, il faut tout arreter 
throw $e ; 

} 

catch (PHPSa"loon_Exception $e) { 

// afficher un message et c'est tout. 

} 

Dans cet exemple, chaque bloc catch traitera les exceptions pour lesquelles il 
est prevu (en fonction de la classe attendue). L'irruption d'une extension 
generique de classe Excepti on ne sera pas, cependant, prise en compte par ces 
blocs. Cette exception se propagera alors des blocs catch vers un bloc try 
englobant, s'il existe, et a defaut, le programme sera interrompu. 

Par precaution, il est done possible de placer un bloc catch general parametre 
par la classe exception, a la suite de traitements plus precis. Nous aurons 
alors la garantie qu'aucune exception, incluant celles non prevues lors des 
developpements, ne passera a travers les mailles du filet. 



try{ 

Instruction 1 ; 
Instruction 2; 
try{ 

Instruction 3.1 ; 

f< Instruction fautive; 

/ Instruction 3.2; 

{ ) 

catch (Autre_Exception $e) { 

= Instruction 3.3; 

\ } 

\ Instruction 4; 

\ } 

I catch (PHPSaloon_Exception $e) { 
Instruction 5; 

?1 catch (Exception $e) { 
\ lnstruction6; 
'"V } 

I Instruction 7; 
Instruction 8; 

Figure 6-2 Propagation d'une exception 
dans une hierarchie de blocs try 
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PHP VS JAVA final lyQ 



Contrairement a Java, PHP ne complete pas try et 
catch par un bloc f inally. Ce bloc est normale- 
ment execute, quoi qu'il advienne, a compter du 
moment ou une exception a ete declenchee et 
ceci, juste avant de poursuivre I'execution du pro- 
gramme (en tout dernier, done). 
Dans la pratique, il est toujours possible de se pas- 
ser d'un tel bloc, son absence ne devrait done pas 
etre penalisante pour PHP 5. 



On pourrait alors penser qu'il suffit de placer un seul bloc catch de ce type 
pour eviter toute difficulte. Dans ce cas, e'est l'identification de la nature 
exacte de l'erreur qui pose probleme. II ne reste, dans cette optique, plus que 
la comparaison des messages d'erreurs pour determiner les actions a mener. 

Quels couts pour les exceptions ? 

Si la prise en compte rigoureuse des erreurs au moyen de codes de retour est 
fastidieuse, son cout est globalement assez faible. Pour les exceptions, la 
mecanique mise en ceuvre au niveau de l'interpreteur est d'une tout autre 
complexite. 

Pour chaque bloc try, il convient en effet de stocker l'etat des informations 
locales pour pouvoir les reconstituer le cas echeant, par exemple dans le 
cadre d'un bloc catch. Ceci prend du temps, et de la memoire. Ces photo- 
graphies du systeme a un instant donne devront par ailleurs etre conservees 
pour chaque hierarchie de bloc try. 

Ainsi, plus les imbrications sont nombreuses, plus le cout est important. 
Etant donne la jeunesse de PHP 5, il n'existe encore aucune mesure concer- 
nant le cout exact du mecanisme. Cependant quelques mesures elementaires 
tendent a montrer qu'il peut rapidement devenir penalisant, d'autant que 
l'utilisation du modele objet est propice a l'utilisation des exceptions et peut 
resulter d'un niveau d'imbrication non negligeable. 



Exceptions ou erreurs : une question 
d'equilibre 

Alors, exceptions ou erreurs ? La querelle ne semble pas avoir de solution et 
dechaine les passions entre ceux qui assimilent les exceptions au pire (le 
goto) et ceux qui voudraient en voir partout. La plupart des langages n'ont 
pas tranche, a l'exception du langage Ada qui en fait un modele de develop- 
pement. 

Faut-il alors utiliser ces exceptions ? Oui, mais avec parcimonie. II est tou- 
jours tentant, comme pour l'heritage, de voir des exceptions a tous les 
niveaux. En realite, dans la plupart des cas, il est possible de traiter sans trop 
de complexite une partie des erreurs, tout en reservant aux exceptions les 
dysfonctionnements ou les evenements qui relevent d'une signification par- 
ticuliere au niveau de l'application. 
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I $db = new sqlite_db('foo') ; 

Elle est susceptible de declencher une exception si pour une raison ou une 
autre (comme un probleme de droit), il est impossible d'ouvrir la base « foo ». 

Prenons le cas de cette autre instruction : 



Dans PHP, ce juste milieu est d'autant plus important que l'introduction des 

exceptions est recente. Toutes les exceptions n'integrent done pas forcement S 
ce mecanisme. II faudra apprendre a vivre avec les erreurs. 

De plus, meme pour une extension « compatible », comme SQLite, les 
choses ne sont pas necessairement aussi simples. C'est le cas de l'instruction 
suivante : 
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Sresult = $db->query('select * from'); 



Elle semble manifestement incorrecte (la table manque) et ne declenchera 
pas d'exception. En effet, les developpeurs ont considere que la syntaxe 
incorrecte d'une requete SQL relevait du warning et non de l'erreur. Sresult 
prend done la valeur f al se sans declencher d'exception. Dans la pratique 
l'utilisation des extensions est done reservee a une situation d'echec fatal 
dans l'extension SQLite. 

Parmi les solutions envisageables, on peut toujours determiner les situations 
exceptionnelles importantes, et ce, des la phase de conception, de maniere a 
determiner (avec plus ou moins de precision) le perimetre des incidents qui 
rentrent dans le cadre des exceptions. 

Dans PHP Saloon, on peut faire usage des exceptions au niveau des cons- 
tructeurs. En effet, des erreurs majeures sont a meme de survenir au moment 
de l'initialisation des objets. Le constructeur ne disposant pas de valeur de 
retour, l'utilisation d'exception est alors tout a fait adaptee. 



METHODE N'utiliser que des exceptions 

Dans un langage comme Ada, toute erreur se materialise sous forme d'exception. II en 
resulte un modele de programmation original. II est tentant de chercher a reproduire cette 
approche en PHP. 

Pour le moment il n'existe malheureusement aucune methode simple pour transformer 
d'emblee les erreurs et warnings PHP en exception. 

II est possible toutefois de parvenir a un resultat approchant en definissant son propre ges- 
tionnaire d'erreurs avec la fonction set_error_handler(). Le gestionnaire defini est 
alors execute lors de chaque erreur, ce qui donne la possibility d'intercepter les erreurs et 
de declencher soi-meme une exception. 
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Ouverture de documents XML, connexion a la 
base SQLite 

Acces a la base compromis 
ProblemeXML 



Traitement par defaut 



Dans notre application, une telle utilisation est d'autant plus simple que les 
principales extensions mises en jeu (SQLite et DOM) definissent chacune 
leurs exceptions de reference. Elles sont susceptibles de les declencher au 
moment de l'initialisation des objets (connexion ou document) : 



class connecte { 

function construct() { 

try { 
// ... 

} 

catch(SQI_ite_Exception $e) { 
// ... 

} 

catch (DOM_Excepti on $e) { 

// 

} 

catch(Exception $e) { 

// 

} 

} 

// ... 
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En resume 



Les exceptions constituent un mecanisme supplemental pour aboutir a du 
code de bonne qualite. En la matiere, PHP 5 propose une version pleine- 
ment satisfaisante. Cependant, il faudra du temps pour que les multiples 
extensions de PHP tirent le meilleur profit de cette nouveaute. 

Par ailleurs, et meme si cela peut paraitre seduisant, les exceptions restent 
une possibilite dont il faudra apprendre a user sans en abuser. Contrairement 
a des langages tout objet, PHP reste un langage fondamentalement proce- 
dural et il serait illusoire de croire que l'integralite des fonctionnalites du 
langage se calquera sur le modele des exceptions. 



chapitre 



I Cooktop - echanges.dtd 



j File Edit XML CodoBila Tools Options Web Window Help 



O - echangea.xml : ityl 



source (xml) |xpath console 

<?xrrl versi ori = "l. ( 

<phpsa"loon> 

<connecte uid=' 
■<pseudo>oupci 
<age>32</ag 



Reports 

F ontiai Current XML - Tidy 

Format Current XML with indent of attributes 

Format and Open XML - Tidy 

Convert andOpanHTML to XSL Tidy 



Tidy 



5.xt:ai:: DTD from n.inen: fi> - JT JO-n-raMn 



J 



<vi 1 1 e>Pan s</vi 1 1 e> 
<region>21</region> 

<LV>Fdll de PHP 5</<_v> 
<phot 0> rHOPGLDOD . gi f </phot o> 
<iri (i>?</tnri> 
</connecte> 

<formula1re u1d«"2" fn»'9'> 

<message name- "form [message] " type-"texte" 
class = "envo"i " question= n ./otre message" ,/S 
</f orinul ai re> 

■ones sage type= correspondanr >hhhhh</message> 
■ones sage type="ut i 1 i sat eur ">jj jj j</niessage> 
<</phpsa"toon> 



j 



• eciiaiiges.iUd 



! tlh.Hh.Hl age ( jfPCDATA ) 



< i ELEHE11T 

< IATTIIST 



connects ( pseudo. age. ville, regie 
connecte uid NMTOKEN ^REQUIRED > 



cv. photo, uid ) > 



< l ELEMENT cv ( * PCDATA ) > 

< ! ELEMENT f ormulairc ( mceoagc ) > 
(lATTT.TRT fnri.il la -ire f i 1 NMTOKEN fRFQUTOTT) > 

< ( ATTLIST formulaire uid NMTOKEN #REQUIRED > 

< i ELEMENT message ( Jf PCDATA ) > 

< ! ATTLIOT >c:»gc clos! NMTOKEN #IMrLIED > 
<IATTLIST message name CDATA JflMPLIED > 

< IATTIIST message ejuestion CDATA #IMPLIED > 
< IATTIIST message type NMTOKEN #REQUIRED > 

< i ELEMENT pliutu ( #FCDATA ) > 

< 1 ELEMENT phpsaloon ( connecte. formulaire. message+ ) > 
< ! ELEMENT pseudo ( JPCDATA ) > 
:: 1 ELEMEKT region ! f PCDATA ) 
< I ELEMENT uid ( #PCDATA ) > 
<! ELEMENT ville ( # PCDATA ) > 
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Echanges et contenus 
XML avec DOM 



Certaines applications web sont encore developpees 
en HTML. Ce chapitre est l'occasion de tourner la 
page pour aborder XML, qui est le langage de 
reference pour les services web et les applications de 
nouvelle generation. D'autant que PHP 5 met en 
oeuvre des fonctionnalites novatrices en la matiere. 
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Les bases sur XML 

► Manipuler les documents XML 
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► XML 
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► DTD 



Pourquoi adopter XML ? 



Personne n'a pu y echapper ; XML est au coeur des preoccupations en 
matiere de developpement. Avant d'entrer dans le vif du sujet, il est impor- 
tant de comprendre ce que recouvre ce terme qui cache une realite plus 
simple qu'il n'y parait. 



A RETENIR XML et I'encodage des caracteres 

Les documents XML sont des documents texte. Par 
defaut, I'encodage utilise est UTF-8. II est naturelle- 
ment possible de preciser un encodage different. 
Traditionnellement, en France, on choisira Iso- 
8859-15 ou a defaut lso-8859-1 si le symbole euro 
n'est pas requis ou I'encodage n'est pas disponible. 



A RETENIR Syntaxe raccourcie 



Lorsqu'une balise n'englobe aucun contenu, il est 
possible d'opter pour une syntaxe plus courte. 
Ainsi : 

<brx/br> 

Pourra etre note comme suit : 
<br/> 

Cette notation n'empeche en rien la presence 
d'attributs : 

<br attri but="foo" /> 



3http://10.128.0.251/v2/ex/07-l.xml- Microto.HHQ 



Fichier Edition Affichage Favoris OuliJs 



<?xml veision-"1.0" encoding-"iso-8859-l M 7 
<recette nDm="Salode de fruits"> 
- <ingredients> 
J)nr;ingredient>Pommes</ingiedient> 

<ingredient>Ananas</ingredient> 
</ingredients> 

<cxplicotionc>Epluchcr, coupcr on des, 
mclangcr a un sirop.</cxplicotion5> 

</rgcott9> 



g]titl(i7/llir«ll«l/T^ 



Internet 



Figure 7-1 Affichage d'un 
document XML par un navigateur 



Tour d horizon 

Premiere etape. Quid du vocable XML ? La forme developpee de cette abre- 
viation est : eXtensible Markup Language. XML serait done un langage. 

En realite, XML est plutot une syntaxe, et e'est la toute sa force. En effet, 
XML a su s'imposer comme une syntaxe universelle pour echanger et decrire 
l'information, sans se preoccuper de la realite des informations echangees. 

Cette syntaxe est par ailleurs excessivement simple (ce qui est probablement 
a l'origine de son succes). Elle reprend le principe des balises HTML en le 
generalisant et en le rendant coherent. 

Un document XML est done un simple document texte dans lequel l'infor- 
mation est structuree par des balises : 

Exemple de document XML 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<recette nom="Salade de fruits"> 
<ingredients> 

<i ng redi ent>Pommes</i ng redi ent> 
<i ng redi ent>Ananas</i ng redi ent> 
</ingredients> 
<explications> 
Eplucher, couper en des, melanger a un sirop. 

</exp~lications> 
</recette> 

Dans ce document, nous avons propose nos propres balises. XML ne nous 
limite pas en la matiere, ce n'est tout simplement pas son objet. II nous dit 
juste comment structurer l'information avec des balises, par exemple en 
imposant que chaque balise soit correctement refermee (ce qui n'est pas le 
cas en HTML, ou il n'est pas rare de voir des balises <p> ou <br> sans leurs 
contreparties </p> et </br>). 

La quasi-totalite des navigateurs sait afficher correctement les documents 
XML en distinguant balises et contenus. C'est le cas de Mozilla et 
d'Internet Explorer. 
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Les langages XML et la DTD de PHP Saloon 

A ce stade, vous pouvez legitimement vous interroger face aux declarations 
dithyrambiques « d'experts » qui « font du XML ». Ceci est globalement 
aussi pertinent que de pretendre ecrire avec des mots, des espaces, des vir- 
gules et des points. 

Quitte a nous repeter, XML est juste une syntaxe. Chacun est done libre de 
definir ses balises, et leur ordonnancement, tout comme chaque langue possede 
ses mots, et definit leur organisation (en francais, par exemple : sujet, verbe et 
complement). Ceci est d'autant plus facile en XML que l'interaction entre tous 
ces vocabulaires est simplifiee par l'utilisation d'espaces de nommage. 

De fait, de nombreux organismes metier definissent leurs langages propres 
en utilisant XML et le W3C, a l'origine d'XML, qui a naturellement pro- 
pose des outils et des langages pour decrire precisement ceux construits sur 
la base d'XML. 

C'est le cas de la DTD (Document Type Definition) qui decrit tout simplement 
la grammaire d'un langage XML en listant pour chaque balise les attributs auto- 
rises, et pour les balises (on parle d'elements), les sous-balises autorisees. 

Cette description supplemental est indispensable. En son absence, il 
devient presque impossible de comprendre un document XML, faute de 
connaitre le role et l'organisation des balises entre elles. Pour continuer notre 
analogie, il vous faut un dictionnaire et un precis de grammaire en francais si 
vous voulez interpreter correctement les phrases, faute de quoi, le flot des mots 
et de la ponctuation vous sera incomprehensible. 



COMPRENDRE Espace de nommage (namespace) 

Dans le langage naturel, il est rare de parler plusieurs langues a la fois. D'ailleurs, rien n'est 
prevu pour melanger dans un meme document ou un meme discours, des elements de lan- 
gues distinctes. 

En XML, c'est tout le contraire. Chaque element peut disposer d'un prefixe qui va preciser 
son langage de reference. On peut ainsi creer des documents composites. 
Les namespaces doivent etre declares avant leur premiere utilisation et un document dis- 
pose d'un espace de nommage par defaut (ce qui evitera de repeter le prefixe). Par ailleurs, 
sauf indication contraire, les noeuds enfants heritent de I'espace de nommage de leur pere. 
La syntaxe retenue consiste a separer le nom de I'element de son prefixe par « : » : 

<phpsal oon : connecte> 

<phpsa~loon :description> 
]e suis un fan de PHP, ma page : 

<htm~l:a href=" . . . ">sur phpfan .com</html :a> 

</phpsal oon : descri pti on> 
</phpsa~loon :connecte> 



RAPPEL Comment fonctionne une DTD 

La DTD decrit la structure d'un document XML (une sorte de gram- 
maire done). Cette description est assez elementaire, elle precise 
pour chaque element (les balises) : 

• la nature des attributs autorises pour un element ; 

• les sous-elements autorises pour ce meme element. 

La syntaxe, quoique legerement exotique, n'est pas bien difficile. 
Considerons par exemple le document XML suivant : 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<a> 

<b>He"l"lo</b> 
<c type="toto"> 
<d>World!</d> 
</c> 
</a> 

II est possible de definir I'element a dans une DTD comme suit : 
<! ELEMENT a (b,c)> 

Ceci signifie que I'element a est compose d'un element b, puis d'un 
element c. Le role de la virgule est d'articuler une sequence. La defi- 
nition suivante decrit quant a elle un element a qui ne pourrait con- 
tenir que b ou c, mais pas les deux en meme temps : 

<! ELEMENT a (b|c)> 

On le voit, tout cela est proche des expressions regulieres, d'autant 
que la syntaxe des DTD reprend, elle aussi, les symboles classiques : 

• ? pour indiquer que I'expression precedents est optionnelle ; 

• + pour indiquer que I'expression est presente au moins une fois ; 

• * pour indiquer que I'expression peut etre soit absente soit repe- 
tee autant de fois que souhaite. 

Ainsi la definition suivante definit a comme susceptible de contenir 
autant de b ou de c necessaires, et ce, dans n'importe quel ordre : 

<! ELEMENT a (b|c)*> 

Lorsqu'un element peut contenir du texte, on utilise le symbole 
PCDATA, ainsi pour notre element d, on peut ecrire : 

<! ELEMENT d (#PCDATA)> 

II faut noter que les parentheses de premier niveau sont indispensa- 
bles, meme lorsqu'un seul symbole est utilise. 



Enfin, deux cas particuliers sont pris en compte : 

• Le cas des elements qui ne comportent pas de contenu, on utilise 
alors EMPTY comme description. 

• Les elements dont le contenu est laisse libre avec le mot-cle ANY. 
La description des attributs est encore plus simple, ainsi pour notre 
element c, on peut ecrire : 

< ! ATTLIST c type CDATA #REQUIRED> 

La syntaxe ne reserve pas de surprise, on precise I'element con- 
cerns I'attribut, le type donne a celui-ci et enfin des options. Ici, le 
mot-cle CDATA signifie que la valeur est du texte, et #REQUIRED 
que cet attribut est obligatoire. #IMPLIED signifierait optionnel. 
En plus de CDATA, il est possible de definir une enumeration, par 
exemple : 

<! ATTLIST c type (toto|titi) #IMPLIED> 

Dans ce cas, I'attribut type est optionnel et peut prendre soit la 
valeur toto, soit la valeur ti ti . 

On le voit, les choses peuvent devenir rapidement malaisees si le 
langage XML a decrire est vaste. Dans le cas de notre exemple, une 
DTD validant notre document serait : 

<?xml version=1.0 encoding=iso-8859-l ?> 

<! ELEMENT a (b,c) > 

<! ELEMENT b (#PCDATA) > 

<! ELEMENT c (d) > 

<! ELEMENT d (#PCDATA) > 

<! ATTLIST c type CDATA #REQUIRED > 

II faut toutefois avoir en memoire qu'il s'agit d'une DTD parmi 
d'autres ; un document donne ne suffit pas a decrire un langage. II 
convient done de bien definir la nature des documents qui seront 
manipules avant d'ecrire la DTD. 

Une autre DTD acceptable pour notre document est par exemple : 

<! ELEMENT a (b,c*) > 

<! ELEMENT b (#PCDATA|d) > 

<! ELEMENT c (#PCDATA| d*) > 

<! ELEMENT d (#PCDATA| EMPTY) > 

<! ATTLIST c type CDATA #IMPLIED > 

Dans ce cas, d'autres profils de documents vont etre conformes a 
cette nouvelle DTD, documents qui ne sont peut-etre pas autorises, 
d'un point de vue applicatif. 

La syntaxe precise d'une DTD dans la recommandation du W3C : 
► http://www.w3.org/TR/2004/REC-xml-20040204/ 
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Dans le cas de PHP Saloon, nous allons ainsi manipuler des listes de con- 
nectes (« connecte » sera done un des elements present dans nos documents 
XML). Voici un exemple : 

Document XML representant une liste de connectes 

<?xml version="1.0"?> 
<phpsa~loon> 
<connectes> 

<connecte uid="l"> 
<pseudo>foo</pseudo> 
<age>32</age> 
<vi 1 1 e>Pari s</vi 1 1 e> 
<cv>fan de php5</cv> 
</connecte> 
<connecte uid="45"> 
<pseudo>bar</pseudo> 
<age>25</age> 
<vi 1 1 e>Rennes</vi 1 1 e> 
<cv>fan de Perl</cv> 
<photo>C0405K40CK40 . png</photo> 
</connecte> 
</connectes> 
</phpsa~loon> 

Dans une DTD, on pourrait alors indiquer : 

DTD validant la liste des connectes 

<! ELEMENT phpsaloon (connectes)> 
<! ELEMENT connectes (connecte) *> 

<!ELEMENT connecte (pseudo, age?, ville?, cv?, photo?)> 
<! ATTLIST connecte uid CDATA #REQUIRED> 
<! ELEMENT pseudo (#PCDATA)> 
<! ELEMENT age (#PCDATA)> 
<! ELEMENT ville (#PCDATA)> 

Cette obstination a vouloir decrire tres exhaustivement les langages crees 
peut paraitre excessive. Apres tout, mil ne connait le dictionnaire par coeur et 
certaines constructions syntaxiques laissent parfois reveur. 

Cependant, 1'homme n'est pas un ordinateur et il ne faut pas oublier que, der- 
riere les echanges XML, nous trouverons de plus en plus d'elements critiques : 
financiers ou contractuels. Elements dont il sera fondamental de s'assurer de la 
conformite, au risque, sinon, de voir des facturations bloquees, des rembourse- 
ments mal effectues pour de simples erreurs d interpretation. Avec XML, e'est 
toute une mecanique de suivi et de controle de conformite qui doit le plus sou- 
vent s'appliquer (notamment dans le cadre des services web). 

Dans PHP Saloon, nous allons eviter ces aspects en nous contentant de pro- 
duire les documents XML pour leur rendu sur des clients web, en dehors de 
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Je ne sais pas encore, ca depend du temps! 
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Figure 7-2 Le rendu final du document XML 
lie aux echanges de messages 



tout echange. La validation revet neanmoins un interet dans PHP Saloon : 
s' assurer que le code genere dynamiquement ne comporte pas d'erreur. 

Naturellement, ce genre de verification coute cher en temps, et en CPU. 
C'est vrai. Mais en phase de test, de telles verifications vont nous permettre 
de detecter d'eventuelles erreurs dans la generation de nos documents XML. 

Outre les procedures d'identification et d'inscription, PHP Saloon peut se 
decomposer en trois types de documents XML : 

• les listes de connectes (utilisees tant pour avoir la liste effective des con- 
nectes presents que pour celle des amis d'un connecte donne) ; 

• le compteur des messages en attente de lecture ; 

• les fils des discussions et les messages echanges. 

Pour chaque cas, il est possible de definir un document XML type, dont la 
grammaire exacte sera ensuite precisee au moyen d'une DTD. Ainsi, par 
exemple, pour le cas de l'echange de message : 

Document XML utilise pour l'echange de messages 

<?xml version="1.0" encoding="iso-8859-15" ?> 
<phpsa~loon> 

<connecte uid="2"> 

<pseudo>Dupont</pseudo> 

<age>32</age> 

<vi 1 1 e>Pari s</vi 1 1 e> 

<region>21</region> 

<cv>Fan de PHP 5</cv> 

<photo> FHOFGLDOD . gi f </photo> 

<ui d>2</ui d> 
</connecte> 

<formulaire uid="2" fil="9"> 

<message name="form[message] " type="texte" 

class="envoi " guestion="Votre message" /> 

</formulai re> 

<message type="correspondant">hhhhh</inessage> 
<message type="utili sateur">j j j j j</message> 
</phpsa~loon> 

Ce document XML se decompose en trois zones : 

• la description de l'interlocuteur dans la discussion (un connecte) ; 

• le formulaire de reponse ; 

• l'historique du fil de la discussion. 

Cette decomposition se retrouve au final dans l'application, apres mise en 
oeuvre des feuilles de style (voir figure 7-2). 

Nous avons repris a l'identique le modele d'element connecte presente pour 
notre liste de connectes (voir « Document XML representant une liste de 
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o 
a 

at 
> 

connectes », page 125). Cela va nous permettre de simplifier sensiblement la Z 

grammaire de nos documents XML tout en ameliorant la coherence 

d'ensemble. 

= 

A partir de ce document type, nous pouvons reprendre la DTD originale ^ 
presentee precedemment, en la completant comme suit : <S 

c 

Premiere version de la DTD du langage XML de PHP Saloon >«§ 

<! ELEMENT phpsaloon ( connectes | (connecte?, formulaire, message*) ) > 
<! ELEMENT connectes (connecte)+ > 

<! ELEMENT connecte ( pseudo, age?, ville?, region?, cv?, photo?, irid? ) > 

< ! ATTLIST connecte uid NMTOKEN #REQUIRED > 

<! ELEMENT formulaire ( message ) > 

< ! ATTLIST formulai re fil NMTOKEN #REQUIRED > 

< ! ATTLIST formula! re uid NMTOKEN #REQUIRED > 

<! ELEMENT message ( # PC DATA ) > 

<! ATTLIST message class NMTOKEN #IMPLIED > 

<! ATTLIST message name CDATA #IMPLIED > 

<! ATTLIST message question CDATA #IMPLIED > 

<! ATTLIST message type NMTOKEN #REQUIRED > 

<! ELEMENT age ( #PCDATA ) > 

<! ELEMENT cv ( #PCDATA ) > 

<! ELEMENT photo ( #PCDATA ) > 

<! ELEMENT pseudo ( #PCDATA ) > 

<! ELEMENT region ( #PCDATA ) > 

<! ELEMENT uid ( #PCDATA ) > 

<! ELEMENT ville ( #PCDATA ) > 



OUTIL Generer automatiquement 
une DTD avec Cooktop 

Cooktop est un outil gratuit vraiment tres 
interessant, nous en reparlerons d'ailleurs 
dans le prochain chapitre. 
Cet outil propose, comme bien d'autres, de 
generer une DTD automatiquement a partir 
d'un document XML. Le resultat est tou- 
jours decevant. Mais il faudrait pour cela, 
partir non pas d'un mais de plusieurs docu- 
ments, judicieusement choisis de surcroTt. 
Neanmoins, la DTD ainsi generee peut ser- 
vir de base de depart. En outre, si la syntaxe 
precise des DTD ne vous est pas encore 
familiere, cela aura le merite de proposer un 
exemple tout pret. 
► http://www.xmlcooktop.com/ 
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■ formula: 
( liTTTTRT fnmnlfl- 
< ! ATTLIST formula: 

<! ELEMENT message ( ffPCDATA ) > 

< IATTLICT message class HMTOKEH $ I HrL I ED > 
i. I ATTLIST message name CDATA *IHPLIED > 

<IATT1IST message auestion CDATA HMPLIED ; 
< ! ATTLIST message type NMTOKEN # REQUIRED > 

-.IELEMEHT uliuLu ( CPCDATA ) > 

< ! ELEMENT Dhcsaloon ( connecte. formulaire 

< IELEMEHT pseudo ( JPCDATA ) > 
; I ELEMENT region ( f PCDATA ) > 

: 1 ELEMENT uid ( #PCDATA ) > 

IELEMEHT ville ( PCDATA ) > 
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Figure 7-3 Generation automatique d'une DTD avec Cooktop 
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Au final, en tenant compte de l'ensemble des modules de PHP Saloon (y 
compris les procedures d'inscription et d'identification), on aboutit a une 
DTD qui permettra de valider l'ensemble de nos documents : 



Version finale de la DTD de PHP Saloon 



<! ELEMENT phpsaloon ( connectes | nofriend | 

nomessage | nouveaumessage | 
(connecte?, formulaire, 
(info | message*)) ) > 

<! ELEMENT connectes (connecte)+ > 

<! ELEMENT connecte ( pseudo, motdepasse? , age?, 
vi lie?, region?, cv?, 
photo?, uid? ) > 
<! ATTLIST connecte uid NMTOKEN #IMPLIED > 
<! ATTLIST connecte titre CDATA #IMPLIED > 
<! ATTLIST connecte type CDATA #IMPLIED > 

<!ELEMENT formulaire ( message | (connecte+) ) > 
<! ATTLIST formulaire fil NMTOKEN #IMPLIED > 
<! ATTLIST formulaire uid NMTOKEN #IMPLIED > 

<! ELEMENT message ( #PCDATA ) > 

<! ATTLIST message name CDATA #IMPLIED > 

<! ATTLIST message question CDATA #IMPLIED > 

<! ATTLIST message type NMTOKEN #REQUIRED > 

<! ELEMENT nofriend EMPTY > 

<! ELEMENT nomessage EMPTY > 

<! ELEMENT nouveaumessage EMPTY > 

<! ATTLIST nouveaumessage nombre NMTOKEN #REQUIRED > 

<! ELEMENT age ( #PCDATA ) > 

<! ATTLIST age name CDATA #IMPLIED > 

<! ATTLIST age question CDATA #IMPLIED > 

<! ATTLIST age type NMTOKEN #IMPLIED > 

<! ELEMENT cv ( #PCDATA ) > 

<! ATTLIST cv name CDATA #IMPLIED > 

<! ATTLIST cv question CDATA #IMPLIED > 

<! ATTLIST cv type NMTOKEN #IMPLIED > 



<! ELEMENT photo ( #PCDATA ) > 

<! ATTLIST photo name CDATA #IMPLIED > 

<! ATTLIST photo question CDATA #IMPLIED > 

<! ATTLIST photo type NMTOKEN #IMPLIED > 

<! ELEMENT pseudo ( #PCDATA ) > 

<! ATTLIST pseudo name CDATA #IMPLIED > 

<! ATTLIST pseudo question CDATA #IMPLIED > 

<! ATTLIST pseudo type NMTOKEN #IMPLIED > 

<! ELEMENT motdepasse ( #PCDATA ) > 

<! ATTLIST motdepasse name CDATA #REQUIRED > 

<! ATTLIST motdepasse question CDATA #REQUIRED > 

<! ATTLIST motdepasse type NMTOKEN #REQUIRED > 

<! ELEMENT info (#PCDATA | a) * > 

< ! ATTLIST info type (messagel error) #REQUIRED > 

<! ELEMENT a (#PCDATA) > 

< ! ATTLIST a href CDATA #REQUIRED > 

<! ELEMENT region (#PCDATA| option)* > 
<! ATTLIST region name CDATA #IMPLIED > 
<! ATTLIST region question CDATA #IMPLIED > 
<! ATTLIST region type NMTOKEN #IMPLIED > 

<! ELEMENT option (#PCDATA) > 

<! ATTLIST option value CDATA #REQUIRED > 

<! ELEMENT uid ( #PCDATA ) > 

<! ELEMENT ville ( #PCDATA ) > 

<! ATTLIST ville name CDATA #IMPLIED > 

<! ATTLIST ville question CDATA #IMPLIED > 

<! ATTLIST ville type NMTOKEN #IMPLIED > 



Cette DTD peut etre representee graphiquement de maniere un peu plus 
lisible. La plupart des outils commerciaux d'edition XML le permettent, 
plus ou moins heureusement (figure 7-4). 
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Figure 7-4 Representation arborescente 
de la DTD utilisee pour PHP Saloon 



OASIS, RosettaNet, des organismes pour des langages XML metier 

Si chacun peut definir son langage XML, il va de soi, qu'en pratique, il est indispensable de 
definir des langages communs, sinon comment echanger ? 

C'est pourquoi plusieurs organismes se sont penches sur la definition de langages XML lies 
aux besoins des entreprises et de certains metiers. Les deux efforts les plus importants sont 
portes par deux consortiums : 

• OASIS ; 

• RosettaNet. 

Ces deux consortiums internationaux travaillent desormais ensemble. 

► http://www.rosettanet.org 

► http://www.oasis-open.org 

► http://www.ebxml.org 



ALTERNATIVE Schemas XML et Relax NG 

Utiliser une DTD est un premier pas pour decrire 
un langage XML. Cette approche demeure 
quand meme un peu simpliste. Aucune methode 
de description ne sera jamais parfaite, mais les 
DTD sont neanmoins assez grossieres. Le W3C 
s'est done attele a une methode plus fine, il 
s'agit des schemas XML. 
De son cote, I'OASIS a defini Relax NG, une 
autre methode pour decrire les choses. Actuelle- 
ment, et probablement pour des raisons histori- 
ques, les descriptions avec DTD sont les plus 
courantes. Cependant, I'utilisation des schemas 
et de Relax NG est en progression constante. 
PHP5 et son extension DOM sont tres eclecti- 
ques en la matiere. 
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Les chapitres 9 et 10 montrent des versions XUL/ 
Mozilla et i-mode de PHP Saloon. 



XML oui, mais pourquoi faire dans PHP Saloon ? 

Nous avons defini la structure des documents XML qui seront manipules ou 
crees dans PHP Saloon. Cependant, sauf extensions particulieres de notre 
systeme de chat, nous n'echangerons aucune information avec qui que ce 
soit. Dans ce cas, n'est-il pas un peu excessif de vouloir s'imposer XML ? 

Si Ton se restreint a la seule notion d'echange, il est clair que PHP Saloon ne 
requiert en rien XML mais son utilisation le dotera neanmoins de cordes 
supplementaires. 

1 En decrivant le contenu avec XML, nous le separons de maniere claire 
de la forme (c'est-a-dire des operations de mise en page). 

2 Cette separation permet de proposer plusieurs interfaces, chacune adap- 
tee a un media (telephone, navigateur classique, navigateur riche). 

Ces deux aspects sont essentiels. Au fil du temps, le langage HTML a ete 
detourne de son objectif et est aujourd'hui principalement utilise comme 
langage de mise en page tandis qua l'origine, il s'agissait de presenter une 
information structuree simplement dont la mise en forme devait etre confiee 
a des feuilles de style CSS. 

Aujourd'hui, la creation de sites dynamiques aboutit done a un joyeux 
maelstrom dans lequel se melangent l'acces aux donnees, le code (PHP, 
Perl...) et la presentation. Le resultat est une maintenance delicate quand 
elle n'est pas impossible et une adaptation laborieuse aux differents modes de 
consultation disponibles aujourd'hui. 



REGARD DU DEVELOPPEUR Web et accessibility 

Les premieres versions du langage HTML s'interessaient principalement au contenu, et a sa 
structure (de maniere simplified), en proposant pour un document la definition d'un titre, 
de chapitres ou de paragraphes. 

Cette ambition originale a ete detournee pour rendre le Web plus « avenant ». Au fil du 
temps, notamment de par la course entre editeurs de navigateurs, on a augmente le lan- 
gage HTML en introduisant des elements de mise en page, ou en detournant I'utilisation de 
certains elements aux fins de mise en page (par exemple, les tableaux). 
Avec HTML 4.01 et XHTML, le W3C revient aux sources. II recentre HTML et surtout XHTML 
sur la description du contenu et confie les details de mise en page a des feuilles de style (les 
fameuses CSS). 

Avec cette methode, e'est toute I'accessibilite du Web qui s'en trouve amelioree. II devient 
possible de proposer des styles differents, pour s'adapter a I'outil de navigation, mais aussi 
et surtout pour prendre en compte les besoins de personnes mal-voyantes, par exemple. 
Le W3C accompagne ce recentrage de nouvelles fonctionnalites pour permettre une 
meilleure navigabilite sans la souris (organisation des formulaires, accesskeys). C'est un pas 
important pour revenir sur I'exclusion de populations entieres, du fait meme de ce detour- 
nement du langage HTML. 
► http://www.w3.org/ 
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II suffit pour s'en convaincre, d'observer les difficultes avec lesquelles les sites 
modernes s'adaptent aux deux navigateurs les plus repandus : Microsoft 
Internet Explorer et Mozilla. 

Au final, cette complexity nuit a l'accessibilite du Web. Cela vaut naturelle- 
ment pour les utilisateurs classiques, qui sont confrontes a des sites plus ou 
moins recalcitrants en fonction du navigateur utilise, mais aussi, et surtout, 
cet etat de fait constitue une veritable barriere a l'utilisation du Web par les 
utilisateurs victimes d'un handicap (difficultes motrices, mal-voyants). 

En utilisant XML, et en le transformant dynamiquement pour obtenir le 
site le plus adapte au visiteur, PHP Saloon va done repondre au mieux a 
cette notion d'accessibilite tout en beneficiant de la conception simplifiee 
qui resulte d'une meilleure organisation des differentes composantes : don- 
nees, traitements et presentation. 



Document Object Model : une interface 
disponible dans PHP 

Le W3C aurait pu s'arreter a la definition d'XML. Cependant, un docu- 
ment XML en tant que tel ne sert a rien. II doit etre analyse pour que 
l'information contenue soit exploitee. Faute de standard en la matiere, il y a 
fort a parier que chacun y serait alle de son propre systeme d'analyse. 

Le W3C a done defini une modelisation pour les documents XML, et sur- 
tout une interface pour manipuler le modele, et ainsi modifier, lire, detruire 
les informations des documents XML. Ce standard est DOM (Document 
Object Model). 

Dans DOM, tout document XML est decrit comme un arbre. Chaque element, 
ou balise, est represente sous forme de noeud, le contenu, comme des feuilles. 

Les fonctions de l'interface DOM sont done beaucoup plus simples qu'il n'y 
parait. Sous leurs airs rebarbatifs, il ne s'agit en realite que d' arboriculture : 
on enleve des branches, on en greffe, on elimine des feuilles pour se tailler un 
document sur mesure. 

Dans PHP Saloon, nous allons tres exactement proceder de la sorte, tantot 
en modifiant un document XML de reference, pour y placer les informa- 
tions d'un connecte, tantot en creant un document a partir de rien et en y 
ajoutant branches et feuilles. 

Qu'il s'agisse de PHP 5 ou de PHP 4, la maniere la plus simple, et celle con- 
seillee, pour manipuler un document XML avec DOM consiste a utiliser les 
objets, meme si i'ensemble des fonctions DOM reste disponible pour des 
raisons de compatibilite. 



PHP 4 Attention 
aux noms des fonctions DOM 

Dans PHP 4, I'extension DOM a ete largement 
victime de sa jeunesse. En realite, elle a ete inte- 
gree et rendue disponible rapidement dans PHP, 
alors meme que le nom des fonctions n'etait pas 
stabilise. 

II faut savoir que le W3C, avec DOM, ne se con- 
tente pas de definir une modelisation pour les 
documents XML et HTML, mais definit aussi une 
API de maniere tres precise. 
Au fil du temps, les developpeurs de PHP ont 
done rectifie les erreurs de I'extension DOM 
pour adopter les noms imposes par le W3C. 
Certains anciens noms restent disponibles pour 
des raisons de compatibilite mais rien ne garan- 
tit leur maintien, alors meme que l'interface pri- 
vilegiee pour manipuler les documents XML 
reste l'interface objet... 

La documentation PHP de I'extension DOM liste 
les changements de noms de maniere precise. 
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DOM, premier contact avec le formulaire 
^identification 



B.A.-BA Majuscules ? Minuscules ? 

Faut-il utiliser des majuscules ou des minuscules 
pour le nom des fonctions et des variables en 
PHP ? Peu importe, PHP n'est pas sensible a la 
casse. 

Attention toutefois, quand vous interrogerez PHP 
sur le nom de variables ou de fonctions, celui-ci les 
retournera toujours en minuscules. C'est le cas par 
exemple avec les fonctions : 
get_decfared_cfass() ou 
get_obj ect_methods () 



Pour explorer plus en detail ['utilisation de DOM dans PHP, nous allons 
definir de A a Z la procedure d'identification a PHP Saloon. 

Cette procedure doit : 

• proposer le code XML correspondant au formulaire de connexion a PHP 
Saloon ; 

• gerer le traitement de la reponse. 

Un des moyens de simplifier cette premiere etape est de partir sur la base 
d'un document XML pre-existant qui va nous servir de modele. Ce docu- 
ment est bien evidemment conforme a la DTD qui vient d'etre etablie. 

II faut aussi noter que ce document type pourra servir pour la mise au point 
des transformations XSLT lorsqu'il s'agira de donner une apparence a tout 
cela (car pour le moment, nous nous limitons a creer le code XML, aucune 
esthetique, done). 

Le modele XML de I'identification a PHP Saloon 

<?xmf version="l. 0" encoding="iso-8859-l" ?> 
<phpsa~loon> 
<formufai re> 
<connecte> 

<pseudo name="form[pseudo] " question="Nom de code" type="stri ng"> 

<! [CDATA[foo]]> 
</pseudo> 

<motdepasse name="form[motdepasse] " question="Mot de passe" 
type="secretstri ng"> 
<! [CDATA[bar]]> 
</inotdepasse> 
</connecte> 
</formufai re> 
<info type="message"> 

Pas inscrit(e)? <a href="inscription.php">Cliquez-ici</a>! 
</i nf o> 
</phpsa~loon> 

Ce document peut etre visualise dans un navigateur (voir figure 7-5) ou dans 
tout autre outil de creation XML. 

Comme nous pouvons le constater, la nature arborescente du document est 
immediatement mise en evidence dans le navigateur. Le document tel que 
modelise dans DOM n'est en rien different. C'est ce type d'arbre qu 'il faut avoir 
en tete quand il s'agit d'appliquer les methodes de l'API proposees par DOM. 

Pour cette premiere confrontation avec DOM, nous allons effectuer des 
manipulations simples, comme le remplacement des valeurs par defaut pre- 
sentes dans notre modele i denti f i cati on . xmf : 
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3 http:/tt0.128.0.251/v2/xml/iaentificaaon.xm] - Microsoft Internet Explorer 
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<Yxml version="l.u" encodinq="iso-BBSy-l" T> 
<php5oloon> 

- <tormulaire> 

- <connecte> 

- <pseudo name="form[pseudo]" question="Nom de code" type='string"> 

<![CDATA[ £uo ]]> 
</pseudo> 

- <motdepasse name-'form[motdepasse]' question-'Mot de posse' type-"secretstring"> 

<![mATA[har ]]> 
<./ftiuldypdbbe> 
</connQctQ> 
</formulaire> 

- <info typo-"mossage"> 

Pas inscrlt(e)? 

<a href-"inscription.php">Cliquoz-ici</a> 

■ k 

</info> 
</phpsaloon> 



I 



Figure 7-5 

Identification. xml dans un navigateur 
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1 charger le document XML (ce qui revient a dire que ce document sera 
analyse et transforme en arbre DOM) ; 

2 explorer l'arbre correspondant ; 

3 modifier la valeur texte du noeud pseudo. 
Commencons par un exemple simple : 

Premier contact avec un document DOM 

<? 

Stree = new domDocument() ; 
$tree->~load('identifi cation. xml ') ; 
echo «<E0F 

L'element racine est : {$tree->documentElement->nodeName} , 
il comporte {$tree->documentElement->childNodes->length} 
element(s) fils.<br> 
EOF; 

?> 

Dans cet exemple, nous creons un objet de la classe domDocument avant d'uti- 
liser la methode load pour charger le document en memoire. Mais cette 
apparente simplicite masque toute une mecanique complexe : le document 
XML a ete lu, analyse, et transforme en arbre. Un arbre dont l'API DOM 
nous permet de recuperer la racine (attribut documentElement) et le nombre 
de fils. Avec le document XML precedent, nous obtenons : 



A RETENIR Comment connaitre les 
methodes et les attributs disponibles ? 



Dans notre premier exemple, nous avons utilise 
des attributs (cela vaut pour les methodes). Les 
plus curieux I'ont peut-etre deja remarque, le 
manuel de PHP manque de precision a ce sujet. 
En realite, la documentation de PHP va progressi- 
vement integrer ces elements, mais il est peut-etre 
encore plus simple d'aller chercher I'information a 
la source : dans la recommandation du W3C. 
On peut ainsi lire, dans la description de I'objet 
Document que : 

• documentElement retourne un objet de type 
Element, et qu'il s'agit d'un attribut public en 
lecture seule. 

• I'objet El ement dispose pour sa part d'un attri- 
but public : nodeName lui aussi en lecture seule 
et permettant d'acceder au nom de la balise. 

Une copie de la recommandation du W3C est pre- 
sentee en annexe de cet ouvrage. 



L'element racine est : phpsaloon, il comporte 5 element(s) fils. 
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Naturellement, il nous faut aller plus loin et explorer completement notre 
document type, puisqu'au final il nous faudra remplacer les pseudos et mots 
de passe fictifs par ceux du connecte. Cette exploration peut etre realisee en 
quelques lignes avec une fonction recursive (voir ci-apres). 

Exploration d'un document XML 

<? 

$tree = new domDocumentO ; 
$tree->load('identification.xml ') ; 
function domExp~lore($node, Sroot = true) { 

if (Sroot) print "<ol>\n"; 

print "<1i> {$node->nodeName}<br>\n" ; 

if ($node->childNodes->length) print "<ol>\n"; 

for($i = 0; $i < $node->childNodes->length; $i++) 
domExp~lore($node->childNodes->item($i) , false) ; 

if ($node->childNodes->length) print "</o~l>\n"; 

if (Sroot) print "</o~l>\n"; 

} 

domExpl ore($t ree->documentEl ement) ; 

?> 



La fonction domExplore n'est guere plus compliquee que le code du premier 
exemple, elle utilise l'attribut childNodes d'un element pour obtenir une liste 
des noeuds enfants (nodeList). Ce nouvel objet comporte un attribut length 
qui donne le nombre de noeuds et une methode, item(), qui va permettre 
d'acceder isolement a chacun d'entre eux. La encore, la recommandation du 
W3C est d'un precieux secours. 

Le resultat de l'execution est presente en figure 7-6. 



Figure 7-6 

Parcours recursif d'un 
document XML avec domExplore () 
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II reserve une surprise. On aurait pu logiquement s'attendre a ce que l'arbre 
explore soit identique a celui affiche par les navigateurs (voir figure 7-5). 

L'origine de cette difference est simple : DOM ne se contente pas de mode- 
liser la structure d'un document XML, il se doit d'en preserver la totalite des 
informations, ce qui inclut les espaces et les retours a la ligne, notamment 
entre les elements. Ainsi, il y a une totale bijection entre le document XML 
et son modele DOM. 

La recherche des nceuds qui nous interessent directement en devient plus 
aleatoire. Par chance, DOM met a notre disposition des methodes comple- 
mentaires, et notamment, getElementsByTagName : 

Recherche d'elements particuliers dans un document XML 

<? 

$tree = new domDocumentO ; 

$tree->~load('identification.xml ') ; 

Spseudos = $tree->getElementsByTagName('pseudo') ; 

print $pseudos->item(0)->nodeVa"lue; 

?> 

Dans cet exemple, la fonction getElementsByTagName retourne une liste de 
noeuds reduite au seul element qui nous importe, l'element pseudo dont le 
contenu sera affiche (en l'occurrence : « foo »). 

II est alors possible de modifier ce contenu pour le remplacer par le pseudo 
reel d'un connecte en modifiant la valeur de 1'attribut nodeVal ue, modifica- 
tion aisement verifiable en provocant l'affichage du document modifie : 

Modification dynamique d'un document XML 

<? 

Stree = new domDocumentO; 

$tree->~load('identifi cation. xml ') ; 

Spseudos = $tree->getElementsByTagName('pseudo') ; 

Spseudo = $pseudos->item(0) ; 

$pseudo->nodeVal ue = 'PHPFan'; 

print $tree->saveXML() ; 

?> 

On peut done imaginer pouvoir proceder de la sorte pour l'ensemble des ele- 
ments a mettre a jour dans notre modele XML. 



'3 http://10.128.0 251/vl/ex/rj7-17.php - Microsoft Internet Explorer 



Fiutaei EuoUuii AfliiLwge Favutis Quids 



*■ Prfc hp * ^ J ffiMMa ^ ^ | J Adrrssr htip:/;i0.l28.0.25l/tf2/«tA)7-l7.p>p 



<?xni! vHrsiiin="l .fl* an co dings'iso-mS^-1' ?> 
<!DOCTYPE phpsaloon (view Source for AiN doctype. . . )> 
<phpcoloon> 

- <formulairg> 

- <connQCtQ> 

CpSBudO rMiHH="fiirifi[fi\Hiiiln]" QjuBSJ h iri="IMiim iJh i:iiiJh" I y|iH="\lrifiij" >PHPFtiri</p\HiJiln> 

- <motdepasse name-"fomi[motdeposse]' question-'Mot de posse 1 type-'secretstring"> 
<!rCDATAfbac J]> 
</motdcpo5co> 
</conn9cte> 
</formulairQ> 

- <infu ty[iH='iiiHssnijM"> 

Pos inscrit(e)? 

<a href="inscription.php">Cliquez ici</a> 

</Infb> 

</pll|ISHlllllM> 




Figure 7-7 Affichage du document XML modifie 



PERSPECTIVES 

L'implantation DOM de PHP 5 sait aussi interpreter les documents HTML 

Dans nos exemples, nous allons exclusivement travailler sur des documents XML qui sont 
directement manipules dans PHP Saloon, mais le W3C a defini DOM aussi pour les docu- 
ments HTML. 

L'extension DOM de PHP 5 ne s'arrete done pas aux seuls documents XML mais est en 
mesure de charger les documents HTML : 

<? 

$dom = new domDocument() ; 

@$dom->l oad ( ' http : //www . w3 . org ' ) ; 

Sliste = $dom->getElementsByTagName(' title') ; 

pri nt $1 i ste->i tem(O) ->nodeVal ue ; 

?> 

Cette facilite est cependant parfois mise a mal par la tres mauvaise qualite des pages 
HTML. Par ailleurs, il est assez courant de ne pas specifier I'encodage de ces pages en sup- 
posant par defaut un mode (iso-8859-1) qui n'est pas celui de I'analyseur XML (utf-8). 



XPath, recherche avancee dans les documents XML 

Cette maniere de proceder fonctionne, mais elle est a vrai dire ardue et ris- 
quee. Difficile de modifier un tant soit peu le document XML sans provo- 
quer de catastrophe, meme un espace risquerait de perturber le bon fonc- 
tionnement de l'ensemble, ne serait-ce qu'en parcourant l'arborescence a la 
maniere de notre fonction domExplore. 

On a vu precedemment qu'il etait possible de retrouver un element en le 
recherchant par son nom. Cette methode apporte un plus mais reste tres 
insuffisante. Par chance, le W3C a complete XML avec le langage XPath. 
XPath va nous permettre de rechercher les elements en fixant des contraintes 



136 



beaucoup plus precises portant principalement sur le chemin entre la racine 
du document et l'element concerne. 

Avec XPath, on pourra, entre autres choses, designer en une seule operation 
de recherche l'ensemble des elements descendants d'un formulaire, nommes 
pseudo et disposant d'un attribut type. 

Dans cet ouvrage, nous n'aborderons XPath que de maniere limitee. Le lan- 
gage en lui-meme est tres riche et la recommandation du W3C en est une 
reference indispensable. Les differentes utilisations possibles dans PHP 
Saloon donneront un bon apercu du sujet. 

Premieres expressions XPath 

Nous allons reprendre la situation precedente en tirant profit d'XPath pour 
ne pas avoir a parcourir notre document identification.xml, ni meme a 
rechercher par nom d'element, et ainsi d'eviter d'en obtenir plusieurs sans 
pouvoir affiner notre recherche. 

Recherche d'un element (ou d'une liste d'elements) avec XPath 

<? 

Stree = new domDocumentO ; 

$tree->~load('identification.xml ') ; 

Sxpathcontext = new domXPath($tree) ; 

Sliste = $xpathcontext->query('formulaire/*/pseudo') ; 

if ($1iste->length) 

$"liste->item(0)->nodeValue = 'PHPFan'; 
print $tree->saveXML() ; 
?> 

Pour ce faire, PHP met a notre disposition la classe domXPath,. Celle-ci 
definit un contexte XPath, sorte d'environnement ou vont etre evaluees les 
futures expressions XPath. Ici, nous avons initialise le contexte avec l'arbre 
DOM de notre document. 

II suffit alors de demander a obtenir les noeuds designes par l'expression 
XPath a l'aide de la methode query. Celle-ci fonctionne sur le meme prin- 
cipe qu'une requete SQL sauf que le langage d'interrogation est XPath. La 
oil une requete SQL retournera des lignes, une expression XPath permettra 
de designer un ensemble de noeuds. 

Ici, l'expression XPath formulai re/*/pseudo designe l'ensemble des elements 
pseudo qui sont aussi des « petits-fils » de l'element formulai re et ceci peut 
importe l'element intermediaire. 

Les regies les plus simples d'XPath sont done tres proches des expressions 
regulieres utilisees sur les fichiers, le separateur / lui-meme est traditionnel- 
lement utilise dans les chemins de fichiers Unix/Linux (utilisateurs de Win- 
dows remplacez / par \ dans votre tete). 



A RETENIR XPath et XSLT 

Nous explorerons plus en detail les expressions 
XPath dans le cadre des transformations XSL pour 
le rendu des documents XML, des le chapitre sui- 
vant. Cependant, XPath meriterait un ouvrage a lui 
seul. 

03 XSLT Fondamental, Philippe Drix, Eyrolles. 
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Nous sommes done en mesure de proposer une premiere version du contro- 
leur utilise pour l'identification. Comme l'ensemble des controleurs est 
charge de creer des document XML, une possibilite interessante offerte par 
le modele objet est de creer une classe controleur derivant de la classe 
domDocument. 



- 1 Controleur pour l'identification, premiere version 



require_once 'icontroleur.php'; 
requi re_once 'utilisateur.php'; 

class controleur extends domDocument implements icontroleur { 
function construct() { 

parent: : construct() ; 

$this->load( ' i denti fi cati on . xml ') ; 

$this->db = new sql ite_db( 'phpsaloon ') ; 

Scontext = new domXPath($thi s) ; 

if ($_P0ST[ 'form']) { 

$this->user = new utilisateur($_POST[ 'form'] [ 'pseudo'J , 
$_P0ST[ 'form '] [ 'motdepasse '] ) ; 

if ($this->user->connecte($this->db) { 



header( 'Location: /site.php ') ; 

exit(O); 



} 



// une erreur s'est produite, connexion impossible 
Slist = $context->query( ' phpsaloon/formulai re ') ; 
Smessage = new domElement( Wnfo ') ; 
$message->setAttri bute( 'type' , 'erreur') ; 
$message->nodeValue = 'Impossible de vous connecter'; 
i f (count ($1 i st->i tem(O) ->chi 1 dNodes) ) 
$1 i st->i tem(O) ->i nsertBef ore($message , 

$list->item(0)->childNodes[0]) ; 

else 

$1 i st->i tem(O) ->appendChi 1 d (Smessage) ; 

} el se 

$this->user = new utilisateur( ' ', ' ') ; 

Slist = $context->query( 'formulai re/*/pseudo ') ; 
$list->item(0)->nodeValue = $this->user->pseudo; 
Slist = $context->query( ' formulai re/*/motdepasse ') ; 
$list->item(0)->nodeValue = $thi s->user->motdepasse ; 



Initialisation du document DOM. 



Chargement du patron XML. 



Connexion a la base. 



Construction du contexte XPath. 



Si le formulaire a ete valide. 



Creation d'un utilisateur. 



Tentative de connexion. 



Redirection vers le chat si ok. 



Creation d'un utilisateur par defaut. 



Remplacement des elements du modele. 
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Le fonctionnement d'une bonne partie des classes control eur utilisees dans 
PHP Saloon sera identique : 

1 charger un modele XML ; 

2 tenir compte de la validation d'un formulaire si necessaire ; 

3 rechercher les nceuds dont le contenu est a modifier ; 

4 alterer leur contenu. 

Notre classe control eur est parfaitement conforme a ce sequencement. Elle 
pourrait d'ailleurs etre utilisee en l'etat. Mais puisque la plupart des classes 
control eur vont mettre en oeuvre les memes actions, il est judicieux de creer 
une classe control eur generique qui inclura par exemple : 

• une methode pour ajouter ou modifier un message d'information ; 

• une methode pour simplifier le remplacement du contenu d'un noeud 
donne. 



COMPRENDRE A propos des sections CDATA 

Quand du code manifestement non conforme a la syntaxe d'un 
document XML (par exemple un morceau de code C++, Java), doit 
etre neanmoins inclus dans un element, il n'est pas toujours perti- 
nent de tout encoder brutalement, comme c'est le cas pour I'affec- 
tation a I'attribut nodeVal ue. 

Le standard XML permet d'inserer des donnees en l'etat dans un 
document XML avec I'utilisation de sections dites CDATA. Une sec- 
tion CDATA est delimitee par deux marqueurs, un au debut, un a la 
fin, qui vont delimiter une zone au contenu libre : 

<?xml version="1.0" ?> 
<code langage="C"> 

< [CDATA [ 

int main(int ac, char *av) { 
i nt i ; 
if (ac < 2) 

exit(l) ; 
for(i = 1 ; i < ac ; i++) 

pri ntf ("Argument %d : %s\n", i, av[i]); 
return 0; 

} 

]]> 

</code> 



Dans le cas de PHP Saloon, on pourrait choisir de creer pour les dif- 
ferents champs (comme celui de description), une section CDATA. 
Le code de la fonction replaceValue() pourrait alors s'ecrire : 

protected function replaceCDATA($element, 
Snouveautexte = ' ') { 
// effacer tout ce qui pourrait 
// se trouver la 

foreach($element->childNodes as Schild) 
$element->removeChild($child) ; 

if (Snouveautexte) { 

// creer le noeud CDATA 

Scdata = new domCDATASection( 

utf8_encode($nouveautexte)) ; 
$element->appendChi ld($cdata) ; 

} 

} 
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On obtient alors une classe control eur : 



Controleur generique 



requi re_once 'i control eur. php '; 

class controleur extends domdocument implements icontroleur { 
protected $form; 

function construct() { 

parent: : construct () ; 

$this->form = $_P0ST[ 'form '] ; 

} 

protected function insertMessage($path, $message_texte) { 
Sxpath = new domXPath($this) ; 
$a = $xpath->query($path) ; 
$msg = new domelement( 'info ') ; 
Stext = new domText() ; 
$a = $a->item(0) ; 

$text->appendData(utf8_encode($message_texte)) ; 
$a->insertBefore($msg , $a->chi ldNodes->item(0)) ; 
$msg->appendChild($text) ; 
$msg->setAttribute( "type", "erreur"~) ; 

} 

protected function replaceCDATA($element, Snouveautexte = ' ') { 
for($i = 0; $i < $element->childNodes->length; $i++) 

$element->removeChi ld($element->childNodes->i tem(0)) ; 
if (Snouveautexte) 

$element->nodeVal ue = Snouveautexte; 

} 

} 

?> 



Au final, notre classe identification peut done etre definie de maniere sim- 
plifiee comme suit 

Controleur pour I'identification, version finale 

<? 

requi re 'utilisateur.php '; 

requi re 'control eur. php '; 

class identification extends controleur { 

function construct() { 

parent: : construct() ; 

$this->load( ' xml /i denti fi cati on . xml ') ; 
Sxpath = new domXPath($this) ; 
$db = new sql i te_db( 'test ') ; 
if ($this->form) { 

Suser = new utilisateur($this->form[ 'pseudo'J , 

$this->form[ ' motdepasse ']) ; 
if ($user->connecte($db)) { 
header( 'Location: site. php'); 
exit(); 

} 
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$this->insertMessage( ' /phpsaloon/ formula! re ' , 
'Votre connexion a echoue. Merci de reessayer 
ulterieurement. ') ; 

} 

$a = $xpath->query( ' formula! re/* /pseudo ') ; 
$this->replaceCDATA($a->item(0) , $this->form[ 'pseudo ']) ; 
$a = $xpath->query( 'formulai re/*/motdepasse ') ; 
$this->replaceCDATA($a->item(0) , $thi s->form[ ' motdepasse '] ) ; 

} 

} 

?> 



Construction de document XML a partir de zero 

Pour tout le code etudie jusqu'a present, nous avons utilise un modele XML 
et travaille directement sur les noeuds du patron. Dans certains cas, il est plus 
efficace de construire le document final a partir de rien, en ajoutant les 
noeuds du document les uns apres les autres. Dans PHP Saloon, il en va 
ainsi pour les listes de connectes ou pour le document indiquant a chaque 
instant le nombre de messages restant a lire. 

Pour ce dernier cas, deux types de documents XML peuvent etre produits : 
<phpsa~loon><nouveaumessage nombre="3" /></phpsa~loon> 

lorsqu'au moins un message est en attente pour etre lu, ou quand aucun mes- 
sage n'est en attente : 

<phpsaloon></nomessagex/phpsal oon> 

Ces documents simples peuvent etre crees nceud par noeud, comme l'ont 
deja montre les fonctions insertMessage() et replaceCDATA(). 

En reprenant notre classe control eur de reference, on peut done definir un 
controleur specifique pour ce petit document : 

Controleur pour les messages en attente 

<? 

require_once 'i control eur. php'; 
requi re_once 'control eur. php '; 
class messages extends controleur { 
function construct() { 

parent: : construct() ; 

Sphpsaloon = new domelement( 'phpsaloon ') ; 

$this->appendChild($phpsal oon) ; 

$db = new sqlite_db( 'test') ; 

// recherche des messages non lus (statut = 0) 



METHODE Les tests de conformite 
sont cruciaux 

On peut etre tente de se dire : a quoi bon tous 
ces tests. Cela prend du temps, coute du CPU... 
Toutes ces objections sont vraies et la validation 
a la volee d'un document dynamique represente 
tout simplement un gouffre en termes de res- 
sources. Cependant, il convient de replacer les 
echanges XML dans un contexte plus large. 
Ceux-ci vont prendre une place considerable en 
entreprise, ils feront notamment I'objet de factu- 
rations. La verification de conformite aura alors 
un impact financier (pourquoi payer une infor- 
mation qui ne respecte pas les criteres prevus), 
et d'autres documents transporteront des infor- 
mations vitales. 

Dans PHP Saloon, les choses ne sont pas trap 
graves, au pire les feuilles de style XSL du chapi- 
tre suivant seront incapables de transformer le 
flux XML en page HTML comprehensible. Rien 
de bien mechant, mais tout n'est pas toujours 
aussi inoffensif. 



$nb = $db->single_query( 'select count(*) from messages 

where destinatai re = ' 
. $_SESSI0N[ 'uid'l . ' and statut = 0'); 

if ($nb) { 

Snewmessage = new dome! ement( 'nouveaumessage ') ; 
$phpsaloon->appendChi ld($newmessage) ; 
$newmessage->setAttri bute( 'nombre ' , $nb); 

} else { 

Snomessage = new domelement( 'nomessage ') ; 
$phpsaloon->appendChi ld($nomessage) ; 

} 

} 
} 

?> 



Validation des documents crees 

L'inconvenient avec les documents dynamiques, comme celui qui va etre 
produit par la classe identification, est que, par essence, on ne peut totale- 
ment garantir la conformite du document genere a un modele de depart. 
Plus precisement, les multiples manipulations qui sont realisees sur l'arbre 
peuvent alterer le format du document ; autant d'incertitudes qui n'ont pas 
de raison d'etre pour un document statique. 

Par chance, nous avons defini la DTD des documents manipules dans PHP 
Saloon. Dynamiques ou pas, ceux-ci doivent s'y conformer et PHP permet 
de sen assurer. 

Tous les processus de validation ont ete integres a la classe domDocument, y 
compris la validation a base de DTD et nous disposons de la methode 
val idate(). 

Dans une phase de test, le code de la page d'identification pourrait done 
prendre la forme suivante : 

requi re_once' identification, php' ; 
Sdocument = new identification() ; 

$document->va~lidate('phpsa~loon.dtd') or die("0ops! Le document genere 
est non conforme. ") ; 

// suite du code effectuant la transformation XSL. 

Cette validation provisoire permettra l'identification des defauts dans 
l'implantation des documents et pourra etre simplement commentee en pro- 
duction. 
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ALTERNATIVE D'autres outils de validation 



Si la definition de DTD est un element deja tres utile pour s'assurer de la conformite des 
documents XML a une semantique donnee, la methode reste plutot primitive et tres large- 
ment insuffisante dans un contexte plus exigeant. 

Le W3C a done propose un outil de description alternatif : les schemas, plus complexes a 
mettre en ceuvre, ils decrivent avec plus de finesse les langages XML. PHP 5 permet la vali- 
dation avec de tels schemas via la methode schemaVal idate(). 
Par ailleurs, dans le meme temps, I'OASIS a defini Relax NG comme un autre langage de 
description semantique. Dans PHP, la methode relaxNGVa~lidate() est disponible. 
Les deux approches, Relax NG et Schemas, sont puissantes, le choix est en ce domaine sujet 
a querelles de chapelles. Pour plus d'informations, on pourra consulter le site xmlfr.org qui 
propose une introduction a Relax NG et naturellement le site du W3C pour la recommanda- 
tion sur les schemas XML. 
► http://xmlfr.org/actualites/xmlfr/0401 16-0001 
CO Schemas XML, Jean-Jacques Thomasson, Eyrolles 
CQ Relax NG, Eric Van der Vlist, O'Reilly 



SimpleXML, une alternative tres seduisante 



DOM, nous le voyons, est d'une grande puissance, chaque nceud d'un docu- 
ment XML peut etre altere et modele precisement. Par ailleurs, derriere une 
apparente complexity, DOM a l'avantage de suivre rigoureusement une 
logique coherente. De plus, l'apprentissage de DOM peut constituer un bon 
investissement car cette interface est desormais le moyen privilegie d'inter- 
agir avec les navigateurs modernes. DOM dispose pour cela d'une interface 
JavaScript en tout point identique a celle disponible pour PHP. 

Cependant, il est vrai que la manipulation quelque peu tortueuse de l'arbre 
des noeuds peut paraitre insurmontable. PHP dispose dans ce cas d'une autre 
extension, promise a un grand avenir, eu egard a sa simplicite : SimpleXML. 

Avec SimpleXML, PHP va construire non pas une arborescence de nceuds 
DOM mais, plus directement, une arborescence d'objets PHP prets a 
l'emploi. II devient alors elementaire de travailler sur les documents XML. 

La valeur de chaque nceud est rendue accessible sous forme d'attributs des 
objets et les attributs de ces derniers sont disponibles en utilisant la syntaxe 
des tableaux. 



PHP 4 SimpleXML est aussi disponible 

Les dernieres versions de PHP 4 disposent elles 
aussi de I'extension SimpleXML. On peut done 
sans difficulty adapter des developpements exis- 
tants. 
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Reprenons le modele qui nous a servi pour 1'identification (voir « Le modele 
XML de l'identification a PHP Saloon », page 132). Le code suivant va 
nous permettre de realiser en un tour de main les memes operations sans uti- 
liser DOM : 

Manipulation d'un document XML avec SimpleXML 

<? 

Sracine = simplexml_load_fne('identification.xml ') ; 
$racine->formulai re->connecte->pseudo = 'PHPFan'; 
$racine->formulai re->connecte->motdepasse = 'secret'; 
$racine->formulai re->connecte->pseudo['question'] = 'Pseudo?'; 
print $raci ne->asXML() ; 
?> 

Difficile de faire plus simple, d'autant que pour des manipulations plus com- 
plexes, SimpleXML prend egalement en charge les requetes XPath : 

Stableau = $racine->xsearch('formulai re/*/pseudo') ; 

Des lors, on peut se demander pourquoi s'encombrer de DOM ? Deux rai- 
sons a cela. 

Premier point, s'il est possible de transformer un document DOM en objets 
SimpleXML, l'inverse n'est pas possible. Cette bijection peut paraitre super- 
flue, apres tout SimpleXML se suffit a lui-meme ! Oui... et non. Avec 
SimpleXML, il est impossible de realiser les transformations XSL et plus 
generalement impossible, par exemple en matiere de validation, d'acceder a 
la totalite des capacites de DOM. 

Second point, il est sympathique de creer cette avalanche d'objets, mais pour 
les documents legerement volumineux, les choses vont terriblement se 
corser. Le modele objet n'est pas des plus veloces et par ailleurs, il est relati- 
vement vorace en memoire : autant de ressources, memoire et CPU qui ne 
sont pas infinies... 

SimpleXML est une alternative interessante pour manipuler des documents 
de taille raisonnable des lors qu'aucune interaction trop complexe n'est 
requise. Ceci correspond tout a fait a la nature des echanges dans le cadre des 
services web (avec SOAP, XMLRPC). 

Pour PHP Saloon, outre l'aspect didactique, la necessite de transformer nos 
documents placait DOM en position de choix. 



En resume 



Dans ce chapitre, nous avons vu comment construire avec XML un controleur 
propre a chaque situation. Pour une application comme PHP Saloon, il aurait 
ete possible de melanger les donnees de presentation avec la logique applica- 
tive. Cela nous aurait permis d'echapper a la relative complexite de DOM et 
du langage XML. Cependant, et c'est l'objet du chapitre a suivre, il nous aurait 
fallu alors recrire l'application pour chaque cible (mobile, navigateur...). 



chapitre 
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Est ce que cela suppose d'utiliser un predicat ? 
A priori il faut affiner votre extension XPATH 
Comment obtenir le noeud pseudo d'un tel document 

xml ? 



Done 



Affichage sur mesure 
avec XSLT 



Le benefice apporte par l'utilisation d'XML pourrait 
sembler marginal s'il se limitait a l'obtention d'un 
decoupage elegant de PHP Saloon. Or, notre XML 
peut etre transforme pour generer plusieurs types de 
rendus. 

Comme nous le verrons, XML et les transformations 
XSL ouvrent la voie vers un Web accessible et adapte a 
chacun. 
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I Principe general 

i Dans le chapitre precedent, nous nous sommes attaches a produire des docu- 

H ments XML (par ailleurs, conformes a notre DTD). De fait, nous disposons 

:| d'un langage complet et de documents grammaticalement corrects. 

jjj Comme leur nom l'indique, les transformations XSL vont transformer ces 

documents en de nouveaux documents selon un patron et une feuille de style 
qu'il nous faudra au prealable definir. 




Figure 8-1 Le processus de transformation 



COMPRENDRE Creer des documents binaires avec FO et FOP 



Comme les feuilles de style sont elles- 
memes decrites sous forme de langage 
XML, il est impossible de produire autre 
chose que des documents texte avec les 
transformations XSL. L'exemple le plus 
facheux est I'impossibi lite de creer des 
documents PDF, ou PostScript pour 
I'impression. 

Le W3C apporte une solution a ce pro- 
bleme avec FO (Formatting Objects). FO 
est un langage de mise en page XML. Au 
lieu de produire directement un document 
PDF ou HTML, notre transformation XSL va 
creer une description en FO de la mise en 
page et du contenu du document. Cette 
description tres precise sera ensuite con- 
fiee a un convertisseur specifique (un par 
format). L'outil le plus connu dans ce 



domaine est FOP, propose par I'Apache 
Foundation. 

On pourrait done imaginer pouvoir tou- 
jours utiliser FO, meme pour HTML. La rea- 
lite est autre. FO offre une finesse adaptee 
pour les documents imprimes mais inutile 
dans les cas de documents web, d'autant 
que ce systeme de double transformation 
diminue naturellement les performances et 
la reactivite du rendu. 

► http://xml.apache.org/fop/ 



Figure 8-2 

Transformations avec FO 
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Cette feuille de style est decrite dans un langage XML, qui est, la encore, 
defini dans une recommandation du W3C : XSL ou eXtensible Stylesheet 
Language. 

Le processus de transformation ne limite en aucune facon la nature du docu- 
ment produit. II peut s'agir de n'importe quel document texte. Une transfor- 
mation XSL peut done produire un nouveau document XML, a la maniere 
d'un convertisseur. 

Ce type de transformation sera d'un grand recours dans les echanges entre 
systemes informatiques, et plus particulierement pour l'interoperabilite entre 
services web. Dans PHP Saloon, notre objectif n'est pas de reproduire du 
XML mais de generer un format de sortie adapte pour le Web : (X)HTML. 

Linteret du processus est immediat. Comme avec les CSS, mais avec bien 
plus de latitude, il nous suffira d'adapter les feuilles de style au type de navi- 
gateur detecte pour offrir un niveau de confort optimal. Cette adaptation est 
realisable sans meme toucher au cceur de notre application. 

Nous retrouvons done tout l'interet de l'architecture MVC, avec un decoupage 
precis des differents roles. Des roles, en termes de composants informatiques, 
mais aussi en termes de profils de competences. Nous avons ainsi separe des 
activites qui ne relevent pas, le plus souvent, des memes personnes. 

Ce decoupage, qui peut paraitre artificiel de prime abord, permet a chaque 
acteur du projet de regagner en liberte d'action, les developpeurs pour le 
developpement de la logique metier, les graphistes pour l'elaboration du 
Look &cFeeI de l'application et des feuilles de style. 

Linteret des transformations XSL reside moins dans leur simplicite propre 
que dans la methode implicite, avec a la cle : 

• une meilleure interoperabilite ; 

• un decoupage coherent du developpement. 



ARETENIR CSS vs XSLT 

Les transformations XSL peuvent sembler comple- 
xes, surtout si Ton manie deja des feuilles de style, 
de type CSS. 

En effet, avec HTML 4 et XHTML 1, le W3C a deja 
recentre HTML sur le contenu, laissant une grande 
partie de la forme aux CSS. 
Cette objection est fondee. Mais attention, CSS 
reste tributaire du langage HTML, il n'est pas 
question, par exemple, de vouloir se lancer dans le 
WAP ou meme i-mode... 



Instructions PHP mises en oeuvre 

Le principe des transformations XSL est done d'un maniement aise. On ne 
park que d'une moulinette. Linterface desormais disponible dans PHP 5 est 
elle-meme d'une extreme simplicite : 

• une classe de reference pour le processeur XSLT (le moteur qui realise les 
transformations) ; 

• deux ou trois methodes pour lire les feuilles de style et executer une 
transformation. 

Lensemble est intimement lie a DOM, ce qui est logique dans la mesure ou 
les feuilles de style elles-memes sont des documents XML. 



PHP 4 Des possibilites, 
mais beaucoup de tracas 



Avec PHP 4, vous pouvez egalement transformer 
des documents avec XSL. Helas, I'API a ete victime 
de sa jeunesse et les utilisateurs de PHP ont du 
subir les contrecoups de chaque evolution. 
En fonction de la version de PHP 4 (pre ou post 
4.1), differentes options sont possibles, toutes fon- 
dees sur Sablotron, un processeur XSLT developpe 
par la societe GingerAII. 

L'interface reste relativement accessible, meme s'il 
n'est plus question d'objet. Par ailleurs, aucune 
interoperabilite avec DOM n'est disponible. 

► http://www.gingerall.com/ 
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Le code PHP type que nous utiliserons dans PHP Saloon est le suivant : 



Creation du processeur. 



Analyse de la feuille de style avec DOM (le resul- 
tat est un document DOM). 



Association du style au processeur. 



Execution de la transformation sur un document 
DOM (par exemple, un document genere lors du 
chapitre precedent). 



Definition du controleur et de la vue pour cette 
page. 



Construction du document DOM representant la 
page. 



Creation du processeur XSLT. 



Realisation de la transformation et affichage. 



<? 

Sprocesseur 



new XSLTprocessorQ ; 



Sstyle = new domDocument() ; 
$style->load('style.xsl ') ; 

$processeur->importStyleSheet (Sstyle) ; 

print $processeur->transformToXML($document_phpsa~loon) ; 

?> 



Nous avons interet a factoriser ce code en creant une classe vue.reutilisable 
en l'etat pour toutes les pages de PHP Saloon. Nous tirerons profit, une fois 
encore, du modele objet en etendant la classe XSLTprocessor : 

<? 

requi re_once'i/ivue.php' ; 

class vue extends XSLTprocessor implements iVue { 
function transform($xml , Sxslfile) { 
$xsl = new domDocumentO ; 
$xsl->load($xslfile) ; 
$this->importStylesheet($xsl) ; 
return $thi s->transformToXML($xml) ; 

} 

} 

?> 

II suffira alors d'instancier dans chaque page un objet de classe vue pour rea- 
liser le rendu final. Si Ton reprend le cas de la page d'identification, on 
obtient un code limpide : 

<? 

requi re_once 'inc/identification.php' ; 
requi re_once 'inc/vue.php' ; 

Scontroleur = new identificationQ ; 



$vue = new vue() ; 

print $vue->transform($controleur, 'style/identification. xsl) ; 
?> 

Un code PHP quasi identique sera utilise pour toutes nos pages en adaptant, 
a chaque fois, le type de controleur instancie et la feuille de style requise. 
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ALTERNATIVE Laisser le navigateur realiser les transformations XSL 



Dans PHP Saloon, nous avons pris le parti de realiser nous-memes les transformations XSL. 
Ceci est d'autant plus aise que PHP 5 a perennise une interface efficace et simple. 
Cependant, alors que la plupart des navigateurs recents sont en mesure de realiser eux- 
memes les transformations XSL, nous aurions tout a fait pu nous contenter de laisser cette 
charge au navigateur et done, au poste client. 

C'est d'ailleurs I'option qui avait ete choisie dans I'etude de cas du cahier du programmeur 
PostgreSQL, la ou PHP 4 offrait encore un support brouillon des transformations. 
C'est une methode tres simple, puisqu'il suffit d'indiquer dans le document XML la feuille 
de style a appliquer : 

<?xml -stylesheet type="text/xsl " href="style/identification.xsl" ?> 
L'inconvenient de la methode est d'etre totalement ou en partie inadaptee aux navigateurs 
plus ou moins exotiques disponibles sur certaines plates-formes, en particulier les equipe- 
ments mobiles. 

Dans ce cas, le document est tout simplement inaccessible, ce qui constitue un comble pour 
une application web concue autour d'XML et qui devrait done garantir un bon niveau 
d'interoperabilite et d'accessibilite. 

On peut naturellement considerer que les publics exclus sont tres minoritaires. C'est evi- 
demment peu ethique, mais surtout, un des aveugles les plus connus du monde est alors 
exclu : Google. En effet, les moteurs de recherche ne realisent en general aucune action 
particuliere sur les pages. Au final, le risque de ne pas etre reference est grand. 
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Constructions des templates de 
PHP Saloon 

Une fois le code PHP mis au point, nous pouvons entrer dans le vif du sujet : 

, i r mi j . 1 i • . ■ r i CD Philippe Drix, XSLTfondamental, Eyrolles, 2002. 

le contenu des ieuilles de style, celui-la meme qui sera translorme en code 

HTML. Nous n'allons pas explorer de maniere exhaustive XSL, qui merite a 
lui seul un ouvrage. Nous nous contenterons d'en saisir l'essentiel : la struc- 
ture, les instructions les plus courantes, autant de cles indispensables pour 
approfondir ensuite le sujet. 



Structure d'une feuille de style XSL 

Comme evoque precedemment, une feuille de style est un document XML. 
Et comme dans tout document XML, il existe done un nceud racine. Pour 
les transformations XSL, il s'agit de stylesheet (dans le code XML de 
PHP Saloon, il s'agissait de phpsaloon). En outre, on utilise la plupart du 
temps l'espace de nom xsl pour distinguer clairement les instructions XSL 
des balises. 
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NORMES XSLT, XPath, FO 

Pour des raisons pratiques, nous mettons principa- 
lement en avant le langage XSLT, explicitement 
concu pour transformations. L'environnement XSL 
complet defini par le W3C est en realite une 
famille de trois recommandations : 

• XSLT, qui vient d'etre evoque ; 

• XPath utilise pour designer des morceaux de 
documents XML ; 

• FO (Formatting Objects), un langage XML de 
mise en page adapte a la production de tout 
document necessitant une mise en page precise, 
par exemple pour I'impression. 

> http://www.w3.org/Style/XSL/ 



Une feuille de style XSL se presente done toujours comme suit : 
<?xml version="" encoding="" ?> 

<xsl : styl esheet xml ns : xsl="http : //www .w3 . org/1999/XSL/Transf orm"> 

<?-- instructions de transformation ... --> 
</xsl :stylesheet> 

La syntaxe definissant l'espace de nom xsl est quelque peu exotique, mais il 
s'agit juste de designer celui-ci de maniere unique avec un identifiant sous 
forme d'URL. Pour HTML, on utiliserait : 

xml ns : html="http : //www .w3 . org/TR/REC-html 40" 

On pourrait ainsi melanger des instructions et des balises resultant de plu- 
sieurs langages differents. Nous resterons classiques, pour PHP Saloon. 

Des regies, des arbres et des chemins 

Une fois definie cette coquille, qu'en est-il des instructions XSLT en elles- 
memes ? Premiere consigne : oublier les langages proceduraux classiques. En 
effet, avec XSLT, on ne definit pas un programme et des instructions qui 
s'enchainent, mais on ecrit des regies qui vont decrire les transformations a 
appliquer sur des parties du document XML d'origine. Pour les plus curieux, 
voici un exemple de feuille de style XSLT : 

<?xml version="1.0" encoding="iso-8859-l" ?> 

<xsl : stylesheet version="1.0" 

xml ns : xsl="http : //www .w3 . org/1999/XSL/Transf orm"> 
<xsl : tempi ate match="formulai re//* [@type = 'texte']"> 
<di v> 

<xsl :value-of select="@question" /> 
</di v> 

<xsl:element name="textarea"> 

<xsl :attribute name="name"> 

<xsl :value-of select="@name"/> 
</xsl :attribute> 
<xsl :attribute name="class"> 
<xsl :choose> 

<xsl :when test="@class"> 

<xsl :value-of select="@class"/> 
</xsl :when> 

<xsl :otherwi se>champ</xsl :otherwise> 
</xsl :choose> 
</xsl :attribute> 
<xsl : value-of select="."/> 
</xsl :element> 
</xsl : tempi ate> 
</xsl :stylesheet> 

Pendant la transformation, le processeur XSLT (e'est-a-dire le programme 
charge d'effectuer la transformation) va parcourir l'arbre du document XML 
a transformer et, pour chaque nceud, determiner une regie applicable. 
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D'emblee, on peut retenir que l'ordre d'ecriture des regies n'a pas d'impor- 
tance. En effet, pour un noeud donne, le processeur XSLT choisira la regie 
adaptee et pas simplement la premiere regie venue ou la suivante dans la liste. 

Comment le processeur decide-t-il de la regie a appliquer ? En fonction 
d'une expression XPath, ou de celles que nous avons deja rencontrees. 
Chaque regie est identified par une expression XPath donnee. Si le noeud 
courant valide l'expression, alors la regie est applicable. II est done tres facile 
de definir des regies pour transformer des ensembles entiers du document 
XML d'origine. 

La syntaxe adoptee pour une regie (on park de template) est la suivante : 

<xsl :template match="formulai re/connecte"> 

<?-- balises et contenu a ajouter dans l'arbre de sortie --> 

</xsl : tempi ate> 

Lattribut match designe l'expression XPath qui devra etre validee pour que 
notre regie soit valide. Le contenu de l'element template contient des por- 
tions du document final (portions adaptees a la zone que designe l'expres- 
sion XPath). 

Avec ce systeme de regies, le processeur XSLT va construire progressive- 
ment, tout en parcourant le document d'origine, un document de sortie. 



COMPRENDRE Ordre des regies 

Dire que l'ordre n'a pas d'importance serait 
approximatif. Ceci est vrai en general, mais si plu- 
sieurs regies peuvent s'appliquer sur un noeud 
donne, sauf priorite particuliere, le processeur 
choisit la premiere venue dans le fichier... 
On pourrait done dire que l'ordre ne compte pas, 
mais definit neanmoins un niveau de priorite en 
cas de concurrence. 



ALTERNATIVES Systemes de templates vs XML/XSLT 

La methode mise en ceuvre avec les transformations XSL est ele- 
gante, mais parfois perturbante. II faut bien en identifier la mecani- 
que, au risque de perdre son temps a reproduire des schemas ina- 
daptes a ce type de langage (on parle de langage fonctionnel, 
comme Test LISP, par exemple). 

D'autres systemes de templates ont done ete definis pour PHP, 
aucun, cependant, ne dispose de la meme souplesse que le couple 
XML/XSLT. En effet, il s'agit dans la quasi-totalite des cas de definir 
des modeles de pages en leur integrant des instructions (qui depen- 
dent de I'outil utilise) qui automatisent la production d'une partie 
du code de la page finale. 

Ces modeles sont lus par PHP, les instructions analysees, et I'inter- 
preteur PHP lui-meme produit alors la page finale. Le tout est le 
plus souvent couple a un systeme de cache pour de meilleures per- 
formances. 

Dans cette categorie, il suffit de citer Smarty, promu par I'Apache 
Software Foundation (dont PHP est un projet) ou encore Templeet. 
Mais que penser de ces outils ? Certains vous diront que le couple 
XML/XSLT est un cauchemar, trop complexe, qu'XSL est le pire lan- 



gage jamais invente. Certes, le W3C le reconnaTt bien volontiers, 
XSL pourrait (et va) subir un leger lifting pour etre plus abordable. 
Cependant, et il s'agit ici d'une opinion toute personnels, les syste- 
mes de templates se rapprochent plus de la macro C que d'un reel 
environnement de conception pour les applications web. 
D'une part, les syntaxes adoptees par ces outils sont le plus souvent 
tout aussi execrables que celle d'XSL (il s'agit en effet de simplifier 
I'analyse par PHP). D'autre part, la ou avec XML nous avons pu 
totalement decoupler logique metier et apparence, les systemes de 
templates se contentent de deplacer le probleme. La logique metier 
n'est plus melangee au langage HTML, mais aux instructions de 
I'outil de template, quand ce n'est pas a un soupcon de PHP com- 
plementaire... 

Certes, XML et XSLT reclament un effort, mais cet effort peut etre 
salvateur alors que I'avenir est a I'interoperabilite, aux services web 
et, en ce sens, la qualite des developpements n'est plus negociable. 

► http://smarty.php.net 

► http://www.templeet.org 
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Transformation de la page ^identification 



Le mecanisme que nous venons de decrire s'applique a toutes les pages de 
PHP Saloon. Considerons le cas de la page d'identification. Le code XML 
produit a deja ete defini : 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<phpsa~loon> 
<formulai re> 
<connecte> 

<pseudo name="form[pseudo] " question="Nom de code" 
type="stri ng"> 
<! [CDATA[foo]]> 

</pseudo> 

<inotdepasse name="form[motdepasse] " question="Mot de passe" 
type="secretstri ng"> 
<! [CDATA[bar]]> 
</motdepasse> 
</connecte> 
</formulai re> 
<info type="message"> 

Pas i nscrit(e)? <a href="inscription.php">Giquez-ici</a>! 
</i nf o> 
</phpsa~loon> 

II est possible d'identifier quatre operations distinctes si Ton veut produire 
une page HTML : 

1 generer le squelette d'une page HTML classique ; 

2 generer le squelette d'un formulaire ; 

3 pour chaque champ, generer le code equivalent en HTML ; 

4 ajouter un message. 

Toutes ces operations vont etre realisees avec des regies XSL. Nous allons les 
definir les unes apres les autres, avant de detailler le fonctionnement global 
de l'ensemble. 

Le squelette de la page 

Pour cette regie, nous devons identifier deux elements : l'expression XPath 
et le contenu. L'expression XPath est on ne peut plus simple, elle designe 
simplement la racine du document DOM d'origine, car notre squelette 
HTML englobe tout le reste. 

Le prototype de notre regie sera done : 

<xsl :template match="/"> 

<?-- contenu a definir --> 

</xsl : tempi ate> 



Le contenu ne presente rien d'original, il s'agit de reprendre les balises html, S 

head, body et title bien connues, d'ou le contenu suivant : $ 

>— 

a 

<xsl : tempi ate match="/"> £ 
<html> jf 
<title>Bienvenue dans PHP Saloon</title> -j= 
<body> *f 
</body> 00 
</html> 

</xsl :template> 

Naturellement, si nous en restons la, la seule chose qui sera produite risque 
d'etre une page vide ! Pour indiquer au processeur XSLT de continuer son 
analyse de l'arbre DOM original, nous allons nous servir de l'instruction 
apply- templates et en profiter pour ajouter quelques elements de presenta- 
tion entre les deux balises body : 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<title>Bienvenue dans PHP Saloon!</title> 

<link rel="stylesheet" href="style/style.css" type="text/css" /> 
</head> 
<body> 

<fieldset> 
<legend> 

<img src="img/phpsaloon.gif" alt="Logo PHP Saloon"/> 
</legend> 

<xsl :apply-templates /> 
</fieldset> 
</body> 
</html> 
</xsl : tempi ate> 

Cette instruction va relancer le parcours de l'arbre, en partant des enfants de 
la racine qui vient d'etre traitee. II est possible de restreindre l'ensemble des 
noeuds qui seront parcourus : 

<xsl :apply-templates select="formulai re" /> 

Avec cette precision, le processeur aurait certes repris son parcours, mais en 
ignorant le message d'information. 



Le message d'information 

Nous allons prendre en compte ce message avec une regie dediee. II nous 
faut creer un element HTML qui mettra en valeur le texte du message dans 
le document final. Par ailleurs, si Ton se souvient de notre DTD, nous ne 
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SYNTAXE XPath 



Nous decouvrons ici deux nouvelles syntaxes des 
expressions XPath, « . » qui designe assez natu- 
rellement le nceud courant, et « @ » qui va permet- 
tre de specifier un attribut par son nom. 
Dans une expression XPath, on pourra ainsi reali- 
ser des tests sur la valeur des attributs, par 
exemple : 

i nf o [@ty pe= ' e r reu r ' ] 

Ce test recouvre les elements info dont I'attribut 

type est erreur et constitue un moyen d'isoler les 

messages d'erreur des messages d'information 

simples. 



devons pas omettre deux types de messages : standard, a caractere infor- 
matif, et d'erreur, dont la mise en valeur doit etre plus accentuee. 

Void une possibilite de regie XSL : 

<xsl : tempi ate match="info"> 
<xs~l : element name="div"> 

<xsl :attri bute name="class"xxsl :value-of select="@type"/> 
</xsl :attribute> 
<xsl:copy-of select="." /> 
</xsl :element> 
</xsl : tempi ate> 

L'idee retenue consiste a placer le message dans un element di v, en lui appli- 
quant un style qui dependra du type. Pour cela, nous utilisons deux nouvelles 
instructions XSL : 

• xsl : element pour creer un nouvel element dans le document de sortie ; 

• xsl : attribute pour lui associer des attributs. 

On notera par ailleurs que la rigueur du processus nous assure la conformite 
des documents generes aux standards du W3C. 

Enfin nous utilisons egalement une instruction importante : xsl:value-of 
dont l'objectif est de recopier des elements du document d'origine vers le 
document de sortie. Le fonctionnement de cette instruction est simple, une 
donnee est designee avec l'aide d'une expression XPath puis recopiee en lieu 
et place de l'instruction elle-meme. 

Ces deux premieres regies vont nous permettre de suivre le deroulement 
d'une transformation XSL de A a Z. Voyons tout d'abord le resultat avec 
Cooktop : 



Figure 8-3 

Premiere application 
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Ce resultat est satisfaisant a premiere vue. Le squelette de la page est bien 
restitue, y compris la prise en compte de la feuille de style CSS. Le message 
d'information est lui aussi present. 

Cependant, la transformation semble avoir malgre tout opere sur les ele- 
ments du noeud formulaire. Or, nous n avons defini que deux regies, l'une 
supposee s'appliquer sur la racine, l'autre, sur les elements de type info. 



|t Cooktop xmldocOl.xml : 
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Figure 8-4 

Code HTML produit 

par la transformation XSL 



Si Ton regarde le code HTML produit, on constate que l'ensemble des 
champs texte du formulaire ont ete recopies. Ce resultat surprenant tradui- 
rait l'existence de regies cachees. 



COMPRENDRE Les regies de transformation par defaut 

Pour comprendre plus en detail les regies par defaut, le plus simple est encore d'en etudier 
le code. Tres facile, il se contente d'utiliser les instructions de base que nous-memes avons 
deja experimented. Tout au plus, vous decouvrirez une palette de nouvelles extensions 
XPath qui vous sembleront limpides. 

<xsl : tempi ate match="/ 1 *"> 

<xsl :apply-templates/> 
</xsl : tempi at e> 

<xsl :template match="processing-instruction() |comment()"/> 
<xsl : tempi ate match="text() | attribute: :*"> 

<xsl : val ue-of select="."/> 
</xsl : tempi ate> 

Les lecteurs perspicaces qui resteraient dubitatifs quant a I'impact de ces regies, doivent 
noter qu'elles ne sont jamais prioritaires. Ce qui veut dire qu'une regie par defaut ne sera 
jamais preferee a une regie definie explicitement dans une feuille de style. 
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Figure 8-5 

Arbre DOM complet du 
document « identification.xml » 



Ces regies sont de trois ordres et leur objectif est de simplifier les choses en 
evitant l'ecriture de celles « qui vont de soi » : 

• pour permettre l'exploration complete de l'arbre DOM par defaut ; 

• pour recopier les elements texte du document d'origine ; 

• pour eliminer les eventuelles Processing Instructions. 

Dans notre cas, que s'est-il passe ? Les regies par defaut ont provoque le par- 
cours complet de l'arbre DOM du document XML d'origine, y compris les 
elements de la branche formulaire. Lors de ce parcours, ces memes regies 
ont recopie des textes contenus dans cette branche, et dans le cadre de notre 
fichier XML, le pseudo et le mot de passe. Ceux-ci se sont done retrouves au 
milieu de notre mise en page. 
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Un dernier point reste a eclaircir. Pourquoi tant d'espaces et de retours a la 
ligne ? La reponse tient a l'analyse du document XML, ainsi que le rappelle 
la figure 8-5. Nous avons vu au chapitre precedent que l'analyseur XML 
integre dans l'arbre DOM tout ce qu'il rencontre dans le document XML, y 
compris les espaces et les sauts de ligne entre elements : autant de nceuds 
texte que nos regies par defaut vont recopier lorsqu'elles entrent en action. 

Nous pouvons done considerer que l'objectif est atteint, les artefacts lies aux 
regies par defaut seront elimines lorsque les regies prevues pour la gestion de 
l'element formulaire seront integrees a l'ensemble. 
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La feuille de style complete et son interpretation 

Ces regies manquantes sont aux nombre de trois : 

• une pour le formulaire en lui-meme ; 

• une pour le champ texte associe au pseudo ; 

• une pour le champ mot de passe. 

Considerons le cas du formulaire. Notre regie va devoir : 

1 creer le squelette du formulaire avec l'element form et un bouton de 
validation ; 

2 relancer le parcours de l'arbre DOM au milieu de ce squelette pour pou- 
voir traiter les champs pseudo et mot de passe. 

Une regie possible pour aboutir au resultat est la suivante : 

<xsl :template match="formulai re"> 

<form enctype="mu~lti part/form-data" method="post" 
class="phpsaloon"> 
<input type="hidden" name="MAX_FILE_SIZE" val ue="30000" /> 

<xsl :apply-templates /> 
<div align="center"> 

<input class="phpsaloon" title="Valider le formulaire" 

alt="Valider le formulaire" type="image" src="img/go.png" /> 
</div> 
</fo rm> 
</xsl : tempi ate> 

Seule precaution dans cette regie elementaire, applicable a tous les elements 
formulai re : un champ cache indispensable si le formulaire doit telecharger 
le contenu d'un fichier (c'est par exemple le cas pour la photo du connecte). 

Concernant le champ texte, voici une regie applicable, dont nous allons 
detailler les elements nouveaux : 

<xsl : tempi ate match="formulai re//*[@type = ' texte ']"> Q 
<div> Q 

<xsl :value-of select="@question" /> 
</di v> 

<xsl:element name="input"> Q 

<xsl : attribute name="name"> 

<xsl :val ue-of select="@name"/> 
</xsl :attribute> 
<xsl : attribute name="class"> 
<xsl : choose> Q 

<xsl :when test="@class"> 

<xsl : val ue-of select="@class"/> 
</xsl :when> 

<xsl :otherwi se>champ</xsl :otherwise> 
</xsl :choose> 
</xsl :attribute> 

<xsl : attribute name="type">texte</xsl :attribute> 



SYNTAXE XPath 

Le symbole « / » permettait de materialiser une 
relation de filiation, par exemple le f o rmul ai re/ 
pseudo qui reduit le perimetre de recherche aux 
seuls elements pseudo fils d'un element 
formulai re. 

« // » materialise une relation plus large de des- 
cendance. Ainsi, I'expression formulaire// 
pseudo designe I'ensemble des elements pseudo 
situes au sein d'un element formulai re, et ce, 
peu importe le niveau d'imbrication. L'expression 
formulai re/a/b/c/pseudo est done compa- 
tible avec notre premiere expression. 
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<xsl :attribute name="value"> 
<xsl : value-of select="."/> 
</xsl :attribute> 
</xsl :element> 
</xsl : tempi ate> 

Premier point, l'expression XPath :g), qui est de loin la plus complexe ren- 
contree jusqu'a present. Pour l'interpreter, le moyen le plus simple est de la 
lire de droite a gauche. Cette expression designe l'ensemble des elements 
(une expression XPath designe toujours un ensemble de noeuds) disposant 
d'un attribut type egal a 'texte', dont le nom nous importe peu (d'ou le 
symbole « * »), et descendant d'un formulaire. 

Linteret de cette formule est de nous laisser une totale liberte en matiere 
d'organisation du document XML. Peu importe la structuration et le 
nombre d'elements imbriques, nous nous interessons uniquement aux 
champs textes. 

Deuxieme point, le contenu de notre regie. Nous organisons le document 
HTML final en deux zones : 

1 le texte de la question (place dans un element di v) 0 ; 

2 le champ texte lui-meme ©. 

Troisieme et dernier point, pour le champ texte, que nous creons de toutes 
pieces, l'application d'un style CSS par defaut est prevue, dans l'hypothese 
oil aucune classe CSS ne serait specifiee. Cette petite amelioration permettra 
de laisser la place au rendu specifique de certains champs tout en beneficiant 
pour les autres, d'un style par defaut. 

Nous utilisons dans cette optique une nouvelle instruction XSL : xsl : choose © 
qui correspond plus ou moins au swi tch bien connu de PHP, C ou Java. 
Comme souvent, avec XSL, la syntaxe n'est pas des plus concises, et il est 
possible de specifier autant d'alternatives souhaitees avec xsl :when. Loption 
selectionnee est la premiere qui valide une des expressions XPath precisee 
dans l'attribut test. Dans notre cas, nous entendons verifier la presence d'un 
attribut class. 

Enfin, comme on peut s'y attendre, xsl : otherwise permet de preciser une 
action par defaut. 

A ce stade, nous pouvons tout a fait adapter notre regie et l'utiliser indiffe- 
remment pour le mot de passe et le pseudo. Dans ce cas, il suffirait de modi- 
fier l'expression XPath, et notamment la condition portant sur l'attribut type 
(on parle de predicat) comme suit : 

formulai re//* [@type = 'texte' or @type = 'secretstring'] 



L'inconvenient de cette solution economique est de laisser en clair le mot de 
passe lors de la frappe. Celui-ci est traditionnellement masque, les caracteres 
sont alors remplaces par des « * ». 

Nous allons done nous contenter d'adapter notre regie de maniere tres 
simple pour en obtenir une deuxieme, dediee a la transformation des mots 
de passe : 

<xsl : tempi ate match="formulai re//*[@type = 'secretstring']"> 
<div> 

<xsl : value-of select="@question" /> 
</di v> 

<xsl:element name="i nput"> 
<xsl : attribute name="name"> 

<xsl :value-of select="@name"/> 
</xsl :attribute> 
<xsl :attribute name="class"> 
<xsl :choose> 

<xsl:when test="@class"> 

<xsl :value-of select="@class"/> 
</xsl :when> 

<xsl :otherwise>champ</xsl :otherwise> 
</xsl :choose> 
</xsl :attribute> 

<xsl attribute name="type">password</xsl :attribute> 
<xsl attribute name="value"> 
<xsl :value-of select="."/> 
</xsl :attribute> 
</xsl :element> 
</xsl : tempi ate> 

Desormais, toutes les regies indispensables sont definies. II est done possible 
de les regrouper sous forme d'un seul fichier ou de maniere plus judicieuse, 
afin de conserver une approche modulaire en ayant recours, pour notre 
feuille de style globale, a des inclusions : 

<?xml version="1.0" encoding="iso-8859-l" ?> 

<xsl : stylesheet version="1.0" 

xml ns : xsl="http : //www .w3 . org/1999/XSL/Transf orm"> 

<xsl:output method="html " encoding="iso-8859-l" /> 

<xsl :include href="page/standard .xsl "/> 

<xsl :include href="form/standard .xsl "/> 

<xsl : include href="form/string.xsl "/> 

<xsl :include href="form/secretstri ng .xsl "/> 

<xsl :include href="form/info.xsl"/> 
</xsl :stylesheet> 



A RETENIR Les URL utilisees dans les 
includes sont compatibles avec PHP 

L'instruction xsl : i ncl ude requiert une URL : on 
peut naturellement specifier des chemins locaux, 
ou des URL traditionnelles utilisant le protocole 
HTTP. Cependant, Integration parfaite entre 
libXML (qui est le fondement de I'extension XML 
DOM de PHP) et PHP met egalement a disposition 
tous les protocoles et filtres disponibles dans PHP, 
comme I'acces aux fichiers compresses. 



Squelette de la page. 

Squelette du formulaire. 

Regie de transformation du champ texte. 

Regie de transformation du champ mot de 
passe. 

Regie de transformation du message d'informa- 
tion. 
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Le resultat obtenu (avec les directives CSS ad hoc) est celui escompte : le 
formulaire est correctement presente (figure 8-6) et notre controleur va 
traiter les informations qui en resultent, en affichant au besoin un message 
d'erreur (figure 8-7). 



■ Bienvenue dans PHP Saloon! - Mozilla 



File Edit View 



Go Bookmaiks Tools Window Help 
1 iff I hup//10 12S 



3] ^ Search I J, - 




^PHP Saloon^ 

Mom de code 



Mot de passe 



Pas inscrit(e)? Clique_z : ici! 




Figure 8-6 

Transformation complete de la page d'indentification 



■ Bienvenue dans PHP Saloon! - Mozilla 



File Edit View Go Bookmailcs Tools Window Help 



J 31 \& hltpy/lO.KE^J & 




^PHP Saloon^ 

^/otre connexion a 



Votre connexion a 
6choue\ Merci de 
reessayer 
ultcri cure merit. 



Norn de code 
|PHPFan 




Figure 8-7 

Transformation de la page d'identification apres erreur 



b Uicnvenue dans V\W Saloon! Moult. 
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Figure 8-8 

La page d'inscription transformee 



PHP Saloon, vue d'ensemble de la version HTML 

Avec la page d'identification et le formulaire d'inscription qui releve de la 
meme logique, au point de reposer sur les memes regies XSLT (figure 8-8), 
l'ensemble des pages d'acces a PHP Saloon ont ete prises en compte. 

La page interieure (ou principale) sera identique sur le principe. Mais pour 
simplifier les choses et ne pas avoir a produire une page monolithique, nous 
allons definir un squelette en HTML statique comportant des frames. Cha- 
cune sera affectee a un role dedie et l'application conservera une approche 
tres modulaire (figure 8-9). 



Figure 8-9 

Organisation de la page 
principale de PHP Saloon 



Liste des amis 



Liste 
des 
connectes 



Messages en atten 



Formulaire de reponse 
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Le code HTML de la page reprend tres precisement ce decoupage fonc- 
tionnel, tout en modulant quelques elements de decoration : 



requi re_once 'inc/sessionvalide.php' ; 

Ssession = new sessionValide('identification.php') ; 

?> 

<html> 
<head> 

<title>PHP Saloon, le chat oil l'on cause</title> 

<link rel="stylesheet" href="style/style.css" type="text/css" /> 

</head> 

<body> 

<center> 

<table cellspacing=0 cellpadding=4 border=0> 
<tr> 
<td> 

<img src="img/phpsaloon.png" alt="logo php saloon"> 
<f ieldset> 

<legend>Connectes</legend> 

<center> 

<iframe name"connectes" src="connectes . php" f rameborder="0"> 
</if rame> 
</center> 
</fieldset> 
</td> 
<td> 

<f ieldset> 

<1 egend>Ami s</l egend> 

<iframe name="ami s" src="amis.php" f rameborder="0"> 

</if rame> 
</fieldset> 
<f ieldset> 

<1 egend>Messages</l egend> 

<iframe name=messages src="messages.php" scrolli ng="no" 

f rameborder="0"> 
</iframe> 
</fieldset> 
<f ieldset> 

<1 egend>Echanges</l egend> 

<iframe name="echanges" src="echanges.php" f rameborder="0"> 
</if rame> 
</fieldset> 
</td> 
</tr> 
</table> 
</center> 
/body> 
</html> 

Cette organisation modulaire peut, en outre, factoriser un certain nombre de 
regies XSLT utilisees. C'est le cas pour les deux listes affichees : connectes et 



L'acces ail site suppose qu'une session valide est 
en cours. Sinon, il faut renvoyer I'utilisateur vers 
la page d'identification. 



Premier module : la liste des connectes (colonne 
de gauche). 



< Deuxieme module : la liste des amis, en haut a 
droite. 



Troisieme module : les messages en attente, a 
droite au milieu. 



< Quatrieme et dernier module : la gestion des 
echanges en bas a droite. 
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A RETENIR xshoutput 

L'instruction xsl -output a pour objectif de preci- 
ser au processeur XSL les preferences relatives au 
document qui va etre produit de maniere a I'adap- 
ter le plus possible. 

Xsl -output dispose de plusieurs attributs qui 
vont fixer le type de document produit (html, xml, 
texte), les besoins en indentation ou encore, 
I'encodage des caracteres. 



amis. Dans ces deux cas de figure, ce sont des connectes qui sont affiches, 
amis ou pas. Du point de vue XML ou de l'affichage, il n'existe aucune dif- 
ference. 

<?xml version="1.0"?> 
<phpsaloon> 
<connectes> 

•cconnecte uid="l"> 
<pseudo>foo</pseudo> 
<age>32</age> 
<vi 11 e>Pari s</vi 1 1 e> 
<cv>fan de php5</cv> 
</connecte> 
<connecte uid="45"> 
<pseudo>bar</pseudo> 
<age>25</age> 
<vi 11 e>Rennes</vi 1 1 e> 
<cv>fan de Perl</cv> 
<photo>C0400CK40 . png</photo> 
</connecte> 
</connectes> 
</phpsaloon> 

Le code XSL mis en oeuvre sera identique, organise en deux regies : 

• une pour construire le squelette de la page ; 

• une pour produire le code HTML associe a chaque connecte. 

La premiere regie est elementaire et se rapproche naturellement de celle 
definie pour la racine de la page d'identification : 

<?xml version="1.0" encoding="iso-8859-l" ?> 

<xsl :stylesheet version="1.0" xmlns:xsl="http://www. w3.org/1999/XSL/ 
Transform"> 

<xsl: output method="html " encodi ng="i so-8859-1" /> 
<xsl : template match="/"> 

<html> 

<head> 

<title>Liste des connectes</title> 

<link rel="stylesheet" href="style2 .ess" type="text/css" /> 
</head> 
<body> 

<xsl :apply-templates /> 
</body> 
</html> 
</xsl :template> 

<xsl:include href="connecte.xsl" /> 
</xsl : stylesheet> 
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II est important de constater que si les regies par defaut deja evoquees prece- S 

demment peuvent parfois paraitre bien encombrantes, elles nous assurent ici $ 

du parcours totalement automatique de la liste des connectes. C'est la raison ^ 

pour laquelle il suffit d'integrer (avec xsl : i ncl ude) la regie de transformation |> 

type pour un element connecte. || 

Cette regie reste purement conventionnelle, en depit de son apparence plus ^ 
ou moins volumineuse : 

<xsl : tempi ate match="connecte"> 
<xsl:element name="table"> 

<xsl :attribute name="onc~lick"> 

wi ndow. parent . echanges . 1 ocati on= ' echanges . php?ui d= 
*»<xsl :value-of select="@uid"/>' 
</xsl :attri bute> 
<tr> 
<td> 

<xs~l :element name="img"> 
<xsl :attri bute name="src"> 

<xsl :choose> 
<xs~l :when test="norma~lize-space(./photo) = ""> 
img/none. png 
</xsl :when> 
<xsl :otherwise> 

<xs! : val ue-of select=" ./photo" /> 
</xsl :otherwi se> 
</xsl :choose> 
</xsl :attribute> 
</xsl :element> 
</td> 
<td> 

<xs~l : val ue-of select="./pseudo" /> 
<br /> 

<xs~l : val ue-of select="./age" /> 
<br /> 

<xsl : val ue-of select="./vine" /> 
<br /> 

<xs~l : val ue-of select=". /region" /> 
</td> 
</tr> 
<tr> 

<td colspan="2"> 

<xs~l : val ue-of select="./cv" /> 
</td> 
</tr> 
</xsl :element> 
</xsl : tempi ate> 
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ASTUCE Les espaces dans les transformations XSL et les documents XML 

Nous I'avons experiment a plusieurs reprises, I'analyse d'un document XML conserve les 
espaces blancs et les retours a la ligne. Cela vaut naturellement pour le document XML cree 
dynamiquement en PHP, mais aussi pour la feuille de style XSLT. 

Les navigateurs etant parfois tres susceptibles, il peut etre necessaire de faire disparaTtre 
ces espaces. Une solution, brutale, est de les eliminer physiquement des fichiers, mais dans 
ce cas, c'est la lisibilite qui devient problematique. 

Pour resoudre cet inconvenient, XSLT propose plusieurs solutions. Tout d'abord, la fonction 

normal ize-space() dont le role consiste a supprimer les espaces au debut et en fin de 

chame (dans d'autres langages, cette fonction s'appelle trim()) . 

De son cote, I'instruction xs~l:strip-space permet de demander a ce que les textes para- 

sitent certains elements. Pour la liste des connected, nous pourrions ecrire : 

<xsl : strip-space elements="connectes" /> 

II faut noter qu'a I'inverse, il existe xsl :preserve-space (ne serait-ce que pour contre- 
carrer ponctuellement xsl :stri p-space). 



La figure 8-10 represente le resultat final, apres transformation, de nos deux 
listes indues. 



Figure 8-10 

PHP Saloon completement operationnel 
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Depasser les limites d'XSLT avec libXSL 

Dans PHP Saloon, nous nous contentons des possibilites offertes par XSLT. 
Cependant, le nombre de fonctions disponibles (comme normalize-space()) 
est assez limite et peut manquer d'ampleur pour l'utilisateur habitue a PHP. 
Par chance, la bibliotheque libXSLT, usitee dans PHP 5 pour realiser les 
transformations, prend en charge une initiative de la communaute : EXSLT. 
Ce projet definit un ensemble de fonctions, organisees par thematique, qui 
vont etendre le jeu de base disponible dans XSLT. Chaque processeur est 
libre d'implanter ou non ces fonctions qui ne font pas partie integrante de la 
recommandation officielle. Dans PHP, la classe xsltprocesseur propose la 
methode hasEXSLTSupportO pour determiner si EXSLT est active et dispo- 
nible. Une autre possibilite offerte cette fois-ci par l'extension PHP elle- 
meme est d'appeler des fonctions PHP directement depuis les feuilles de 
style XSLT, de la meme maniere que pour SQLite. Pour ce faire, la classe 
xsltprocesseur dispose d'une methode registerPHPfunctions() qui permet 
d'activer la prise en charge au sein des feuilles de style XSL. 

Cette activation effectuee, il est possible de creer des templates de ce type : 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<xsl : stylesheet version="1.0" 

xml ns : xsl ="http : //www . w3 . org/1999/XSL/Transf o rm" 

xmlns: php="http://www. php. net/xsl "> 
<!-- ... --> 

<xsl : tempi ate match="horodatage"> 

<xsl :value-of select="php:function('date' , '%D-%M-%Y')" /> 
</xsl : tempi ate> 
<!-- ... --> 
</xsl :stylesheet> 

Pratique, ce type de raccourcis vous vaudra, sans l'ombre d'un doute, la 
foudre des puristes XSL. Dans PHP Saloon, il serait possible d'en faire usage 
pour proposer une mise en page agreable et un horodatage plus avenant de 
1'historique des conversations. 
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Le site officiel du projet EXSLT : 
► http://www.exslt.org 



Attention de ne pas oublier le namespace asso- 
cie a PHP pour cette extension. 



En resume... 

Dans le chapitre precedent, XML a pu paraitre superflu d'autant que DOM 
semble, a bien des egards, infranchissable. Avec les transformations XSL, on 
s'apercoit rapidement du potentiel apporte par ce choix. Nos feuilles de style 
proposent une premiere apparence, mais demain, ces memes transforma- 
tions pourraient aussi permettre de partager de l'information avec d'autres 
applications pour former une plate-forme de service plus large, ou encore 
offrir au visiteur une accessibilite amelioree grace a plusieurs profils d'inter- 
faces, dont des adaptations pour les personnes souffrant d'un handicap. 
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chapitre 




' Bienvenue dans PHP Saloon! - MoztUa Firefox 




File Edit View Go Bookmarks Tools Help 


>' - «-4> | U http://10.128.0.251/v2/site.xul 





Saloon 



j^JConnectes | ^Arnis | 
stf 





Votre message 



Envoyer! | 



Une version Mozilla/XUL 
facile avec XSL 



Notre version HTML de PHP Saloon est tout a fait 
satisfaisante et nous tirons deja profit de l'architecture 
MVC en termes d'organisation pour le code source. 
Cependant, avec XML et XSLT, nous irons bien 
au-dela de cette premiere etape en creant une version 
plus riche et mieux adaptee aux utilisateurs de la suite 
Mozilla ou de Mozilla FireFox. 
Cette realisation sera d'autant plus aisee qu'XSLT 
permet de ne rien toucher au coeur de PHP Saloon. 



SOMMAIRE 

► Tour d'horizon de Mozilla 

► Nos objectifs 

► La version XUL 

MOTS-CLES 

RDF 

► XUL 
XPCOM 

► JavaScript 



► http://mab.mozdev.org/ 



Mozilla : une plate-forme technologique 
etonnante 

Vbus avez certainement deja eu l'occasion de tester Mozilla. Fonde a ses 
debuts sur le code de Netscape, ce projet a, depuis, pris son envoi en amelio- 
rant la reactivite du logiciel et en posant les fondements d'une veritable 
plate-forme de developpement autour des standards web. 

Aujourd'hui, plus qu'un navigateur, Mozilla est un outil complet qui permet 
de definir rapidement des applications communicantes d'une tres grande 
richesse, qu'elles soient locales ou distantes. Ainsi, c'est sur la base de la 
plate-forme Mozilla qu'a ete realise MAB (Mozilla Amazon Browser), un 
outil qui permet de consulter le catalogue dAmazon de maniere tres pra- 
tique. 
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Figure 9-1 Mozilla Amazon Browser en action 



DANS LA VRAIE VIE Retour d" experience 



Pour en savoir plus, decouvrez I'experience d'une 
entreprise qui construit ses prestations avec 
Mozilla, au travers dune interview exclusive. 
► htttp://www.stephanemariel.com/ 
article.php?id_article=42 



Ce type d'outil est l'exemple meme des possibilites offertes par Mozilla et les 
applications sont nombreuses ; certaines societes font bien compris et deve- 
loppent aujourd'hui leurs applications plus rapidement grace a l'aide de cet 
outil. Dans PHP Saloon, nous allons effleurer le sujet en proposant un 
echantillon des possibilites offertes. 

Pour evaluer le potentiel disponible, il est important de comprendre ce que 
regroupe Mozilla comme briques essentielles. Car, au-dela du moteur de 



170 



rendu (le fameux Gecko) qui federe un certain nombre d'elements, c'est un 
veritable framework qui est defini par Mozilla, avec : 

• une couche d'abstraction (NSPR, Netscape Portable Runtime) pour la 
creation d'applications multi-plates-formes (typiquement Windows, 
Mac, Linux/Unix) ; 

• un modele de composant (XPCOM) pour servir, a la maniere de COM 
pour les environnements Microsoft, de socle a l'ensemble des elements 
de plus haut niveau. XPCOM dispose d'une API pour C/C++ mais aussi 
pour Python, et via XPCONNECT, s'interface avec JavaScript ; 

• Necko, un composant qui implemente l'integralite des protocoles reseau 
classiques, ceux typiquement utilises dans les URL ; 

• Gecko, le moteur de rendu qui supporte l'ensemble des standards du 
Web, XML, HTML, CSS, et qui propose une API conforme a DOM, 
accessible depuis JavaScript. 

• un toolkit pour construire des interfaces complexes avec notamment 
XUL etXBL. 



Applications (Mozilla suite, Firefox. 



XUL toolkit r£ 




gecko 


| JavaScript 


RDF 




- xpconnect |= 


necko 




xpcom 





Nspr 



Systeme d'exploitation 
Figure 9-2 La plate-forme Mozilla 



II faut done reellement cesser de voir en Mozilla un navigateur pataud. En 
premier lieu, le navigateur lui-meme a beaucoup evolue et constitue 
aujourd'hui un concurrent redoutable pour Internet Explorer ; en second 
lieu, cette image d'Epinal ignore la realite d'une plate-forme qui met en 
oeuvre aujourd'hui (avec Xul notamment) des technologies que Microsoft 
lui-meme n'integrera que dans les prochaines versions de son systeme avec 
XAML et Avalon. 



CULTURE DitesZool 

Comme nombre d'acronymes commengant par X, 
XUL se prononce « zool ». 



RDF et les premiers tests de PHP Saloon 
avec XUL 



REFERENCE XulPlanet pour tous 
renseignements sur XUL 

Dans cette version XUL de PHP Saloon, nous 
n'allons adapter que la page principale et n'explo- 
rer qu'une partie des elements disponibles en XUL. 
Pour en savoir plus, le site Xul Planet dresse la liste 
exhaustive des elements du langage et fournit par 
ailleurs un tutoriel tres complet. 
Enfin, il existe depuis peu un Wiki en frangais sur 
le sujet : XulFr.org 

> http://www.xulplanet.com 

► http://www.xulfr.org 



CONFIGURATION XUL et votre serveur web 

XUL est un document XML particulier. A ce titre, 
votre serveur web doit le delivrer en affichant clai- 
rement dans les en-tetes de sa reponse le type de 
contenu appl i cati on/vnd . mozi 11 a . xul +xml . 
A defaut, Mozilla traitera le document selon le 
type de contenu pretendu (en general « text/ 
html ») et hen ne sera affiche comme prevu. 
Pour Apache, ce parametrage est controle via le 
fichier mime. types (generalement situe dans le 
repertoire de configuration a cote du fichier 
httpd . conf ). Verifiez la presence de la ligne : 

appl i cati on/vnd . mozi 1 1 a. xul+xml xul 

qui associe I'extension .xul a ce type de contenu. 



Comme on le devine a l'enonce des protocoles, Mozilla a pris le parti des 
standards de l'lnternet et il n'est done pas surprenant qu'XML soit au coeur 
de l'interface elle-meme. Avec XUL (XML User Interface Language), nous 
allons done decrire en XML l'interface de PHP Saloon, interface bien plus 
riche et conviviale que celle autorisee par HTML. 



REGARD DU DEVELOPPEUR 

La description de l'interface utilisateur avec XML : une methode d'avenir 

Mozilla est un precuseur en la matiere, avec une solution fonctionnelle depuis quelques 
annees, mais les poursuivants sont la. Ainsi, Macromedia (auteur de Flash) propose le 
MXML et sa technologie Flex. 

De son cote, Microsoft entend faire de XAML (prononcez « zamel » a la maniere de XUL) 
un moyen privilegie pour decrire les interfaces graphiques des applications. La oil Mozilla 
propose sa plate-forme et les standards web avec JavaScript et XUL, Microsoft repond avec 
son propre framework .Net et le couple XAML/C#. A I'avantage de ce dernier, la grande 
richesse des classes graphiques des environnements Windows, naturellement disponibles 
en XAML. A I'avantage de Mozilla, un environnement deja en production, une approche 
plus classique pour les developpeurs web (JavaScript et les CSS) qui ne devrait done trau- 
matiser personne et permettre de capitaliser I'experience acquise. 



Composants graphiques 

Pour avoir une image plus precise de XUL, nous allons construire progressive- 
ment une premiere version statique de l'interface souhaitee pour la page prin- 
cipale de PHP Saloon ; mais avant cela, l'incontournable « Hello World ! ». 

<?xml version="1.0" encoding="iso-8859-15" ?> 
<wi ndow 

xml ns="http : //www . mozi 1 1 a. org/keymaster/gatekeeper/ 

there. is. only. xul" 
title="PHP Saloon, le salon oil l'on cause" 
orient="horizontal "> 

<button label="Hello World !" 

oncommand="alert('Eh ! Hello you guys !')"/> 

</window> 

Cet exemple elementaire permet d'ores et deja d'avoir une idee de la structure 
d'un document XUL. Pour Mozilla, une page ou une fenetre applicative rele- 
vent de la meme logique. Dans PHP Saloon, nous n'allons evidemment pas 
nous limiter a construire des boutons. Lidee retenue repose sur une division en 
deux parties de la fenetre. A droite, les echanges et l'envoi de messages, a 
gauche, les listes des connectes et des amis accessibles au moyen d'onglets. 
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' ) Mozilla Firefox - The Browser, Reload 



File Edit View Go Bo okmarks To ols H elp 
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Hello World ! 



[JavaScript Application] 



Eh! Hello you guys ! 



Done 



Figure 9-3 « Hello World ! » XUL en action 

Pour cela, XUL met a notre disposition un certain nombre d'elements : 

• un splitter, qui comme son nom l'indique, va permettre de separer 
l'objet place a gauche et celui place a droite ; 

• une boite a onglets : tabbox pour nos listes de connectes. 

L'approche XML/XUL va tester immediatement notre vision des choses. 
On peut, par exemple, tester le code suivant : 

<?xml version="1.0" encoding="iso-8859-15" ?> 
<window 

xml ns="http : //www .mozi 1 1 a . org/keymaste r/gatekeeper/ 

there. is. only. xul" 
title="PHP Saloon, le salon ou l'on cause" 
orient=" horizontal "> 
<tabbox flex="l"> Q 
<tabs> Q 

<tab label="Connectes" /> 
<tab label ="Amis" /> 
</tabs> 

<tabpanels flex="l">@ Q 

<tabpanel/> 

<tabpanel/> 
</tabpanel s> 
</tabbox> 

<splitter collapse="before" resizebefore="closest" 
resizeafter="closest" /> 

<box flex="3" />O0 
</wi ndow> 



splitter 



tabbox 



box 



Figure 9-4 Organisation de la 
page principale de PHP Saloon XUL 



Nous avons place temporairement une boite Q a droite pour materialiser 
l'espace en question. L'attribut flex 0 permet de preciser la proportion 
occupee par chaque element. Ainsi, dans cet exemple, 1/3 sera reserve a la 



partie gauche, 2/3 a la partie droite (pour le moment notre boite vide). Le 
meme attribut © nous assure que les pages associees aux onglets occuperont 
l'integralite de la hauteur disponible (on aurait pu indiquer 100 % en lieu et 
place de 1). 

L'element tabbox, qui peut paraitre complexe de prime abord, se decompose 
en deux parties : 

1 Des elements tab pour decrire les onglets par eux-memes et notamment 
leur texte, tous ces elements etant regroupes au sein d'un element tabs 
(remarquez le « s ») Q ; 

2 Des elements tabpanel correspondant a la page associee a chaque onglet 
defini precedemment (dans notre cas, ces pages sont vides). Ces elements 
sont regroupes au sein d'un element tabpanels (remarquez le « s »). 0 
Bien entendu, le nombre de tab doit correspondre au nombre de 
tabpanel... 

La figure 9-5 presente ce premier resultat. Pour plus de lisibilite, il est pos- 
sible d'utiliser directement les CSS (dans la pratique, il faudra realiser un 
fichier externe pour tout regrouper). Sur la figure 9-6, chaque element a ete 
colore en ajoutant un style dedie : 

style="background : red;" 
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Figure 9-5 Premier test Figure 9-6 Premier test pour la page principale 

pour la page principale de PHP Saloon de PHP Saloon (version coloree) 



Pour representer les connectes dans chaque onglet, XUL dispose d'elements 
pour placer l'information en grille, dans des boites, et pour afficher des 
images et des textes. Pour un connecte donne, il est possible d'appliquer une 
mise en page identique a celle schematisee en figure 9-7. 



grille 



ligne/connecte 1 



ligne/connecte 2 



ligne 



Image 



bofte verticale 




© 



colonne 1 



colonne 2 



Figure 9-7 Representation d'un connecte avec XUL 



La traduction en XUL est elementaire ; pour l'element grid, il est possible 
de decrire le contenu soit en ligne, soit en colonne. Dans notre cas, nous 
procederons en ligne (une ligne par connecte), l'element columns n'est done 
utilise que pour preciser le nombre de colonnes effectivement requises. 

<?xml version="1.0" encoding="iso-8859-15" ?> 
<window 

xml ns="http : //www .mozi 1 1 a . org/keymaster/gatekeeper/ 
there.is.only.xul" 

title="PHP Saloon, le salon oil l'on cause" 
orient=" horizontal "> 
<tabbox flex="l"> 
<tabs> 

<tab label="Connectes" style="-moz-appearance: none; 

background: green; "/> 

<tab label ="Amis" /> 
</tabs> 

<tabpanels flex="l"> 

<tabpanel style="background : orange; "> 
<g ri d> 

<col umns> 
<column/> 
<column/> 
</columns> 
<rows> 

<!-- premier connecte --> 

<row> 

<image width="64" height="64" src=". ./jean.png" /> 
<vbox> 

<label value="]ean" /> 
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<1 abel val ue="Pari s" /> 

</vbox> 
</row> 

<!-- deuxieme connecte --> 
<row> 

<image width="64" height="64" src=". ./vache_petite.gif" /> 

<vbox> 

-elabel val ue="Stephane" /> 
<label va~lue="Nice" /> 
</vbox> 
</row> 
</rows> 
</gn'd> 

</tabpane~l> 
<tabpane~l/> 
</tabpanels> 
</tabbox> 

<sp~litter collapse="before" resizebefore="closest" 

resizeafter="closest"/> 
<box flex="3" style="background: red;"/> 
</wi ndow> 



Le resultat dans le navigateur est indique en figure 9-8. 
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Figure 9-8 Representation des listes de connected (version statique) 



Sources RDF 

Sur la base de ce document totalement statique, nous pourrions naturelle- 
ment utiliser PHP pour obtenir une generation complete conforme. Cepen- 
dant, cette methode brutale provoquerait la generation systematique de 
l'ensemble des informations dans un document volumineux. 
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Mozilla propose une mecanique beaucoup plus elegante pour construire un 
document dynamique a partir de notre squelette, en tirant profit des sources 
de donnees RDF (Resource Description Framework). 

Comme son nom le laisse entendre, RDF est un langage dont l'objectif est de 
decrire des ressources (qu'il s'agisse d'objets, de personnes, de concepts) ou 
plus precisement des ressources et les relations de ces ressources entre elles. 

C'est cette capacite d'organisation de l'information dont Mozilla tire profit 
en utilisant RDF a diverses reprises, que ce soit pour la gestion des signets, 
des preferences ou l'historique des sites visites. 

Mieux, Mozilla aura recours aux ressources RDF pour construire dynami- 
quement certains elements XUL. Pour PHP Saloon, nous n'allons done pas 
regenerer l'integralite de l'interface, mais plus simplement nous servir des 
transformations XSL pour exprimer les listes de connectes en sources 
d'information RDF A charge ensuite a Mozilla de construire la version 
XUL des listes a partir de ces sources. 

Avant d'examiner plus en detail ce processus, il nous faut cependant regarder 
d'un peu plus pres ce fameux RDF. Comme on pouvait s'y attendre, il s'agit 
d'un langage qui sera represents en XML (notons au passage que l'adapta- 
tion des transformations XSL devrait done etre relativement simple). 

Cependant, pour bien comprendre la nature de RDF, il est preferable de ne 
pas commencer par la syntaxe (en XML) en se concentrant sur les concepts 
mis en ceuvre. Avec RDF, nous allons representer sous forme d'arbre les 
relations entre les ressources. 



REGARD DUDEVELOPPEUR De I'interet de RDF 



RDF se positionne au sein de I'initiative « Web 
semantique » du W3C. L'objectif est de repondre 
aux limites du fonctionnement actuel du Web et de 
I'lnternet. En effet, nous produisons tous des docu- 
ments, ces documents sont rendus disponibles via 
le Web, via des partages de fichiers, mais ils sont 
en realite tous publies en vrac. L'information est 
generalement disponible de maniere non structu- 
re et ce, sans qu'aucune trace du contexte ne soit 
sauvegardee. 

Ainsi, pour rechercher sur le Web, la seule 
methode disponible consiste a scanner tous les 
documents publies et a retenir un sous-ensemble 
de mots presents dans ces documents. II s'agit 
naturellement de la pire methode envisageable. 
Impossible par exemple de demander les pages 
faisant reference a « Mariel, Stephane », celui-la 
meme justement qui est I'auteur du « Cahier du 
Programmeur PostgreSQL ». II va falloir chercher, 
parmi les milliers de reponses obtenues, celles qui 
correspondent a la recherche. 
Avec RDF, nous aurions pu referencer differentes 
ressources (par exemple, I'individu « Mariel, 
Stephane » ou encore I'ouvrage « Cahier du Pro- 
grammeur PostgreSQL ») et leurs eventuelles rela- 
tions (« est I'auteur de »). 




Figure 9-9 Relations entre ressources dans RDF 
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RDF & RSS 



Mozilla n'est pas seul a exploiter RDF. Avec RSS 
(RDF Site Summary), de nombreux sites se servent 
de RDF pour diffuser leur contenu sur Internet. II 
existe d'ailleurs des repertoires de flux RSS. 
Les mecanismes decrits dans ce chapitre peuvent 
tres largement etre re-utilises au sein d'une appli- 
cation PHP pour presenter ces flux, les fusionner 
(on parle de syndication) et les rendre plus large- 
ment accessibles. 
► http://web.resource.Org/rss/1 .0/ 



Pour designer les arcs et les ressources, RDF impose le plus souvent de choisir 
un identifiant unique (dans le vocabulaire W3C, on parle dURI, Uniform 
Resource Identifier, dont l'URL est une version connue). RDF se moque de la 
nature de l'URI, il nous demande simplement de nous assurer que chaque res- 
source en dispose de maniere unique. Dans PHP Saloon, nous adopterons un 
format d'URI tres classique. Ainsi, pour designer un connecte dont le pseudo 
est « toto », nous utiliserons l'URL : http://www.phpsaloon.com/connectes/toto. 

Techniquement, l'ensemble de ce graphe peut etre modelise avec des triplets 
de la forme : 

ressource — > relation — > ressource 
que ces ressources soient des objets composites, ou simplement des litteraux 
(chaine de caracteres, entier...). 

La specification RDF propose une syntaxe XML pour representer ces tri- 
plets en les regroupant sous forme d'elements description. Le reseau de la 
figure 9-9 peut alors s'ecrire : 

<rdf : rdf xmlns: rdf="http://www. w3.org/1999/02/22/rdf-syntax-ns" 
xml ns :ey roll es=" http://www.ey rones.com/rdf"> 
< rdf description about="http: //www. eyrones.com/Informatique/Livre/ 
* 9782212111668/"> 

<eyrones:titre> 

Cahier du Programmeur PostgreSQL 
</eyrones:titre> 
<eyrones:auteur> 

<rdf :Descri ption about="http://www. stephanemariel .com"> 
<eyrones:nom> 

Marie! 
</eyrones:nom> 
<eyrones:prenom> 

Stephane 
</eyrones : prenom> 
</ rdf : Descri pti on> 
</ey roll es : auteu r> 
</rdf: Descri ption> 
</rdf : rdf> 

Dans PHP Saloon, nous allons done reecrire les transformations XSL utili- 
sees pour les listes de connectes, de facon a obtenir une description RDF de 
ces informations. Dans notre cas, il va s'agir de produire une sequence de tri- 
plets chacun designant des connectes. 



Figure 9-10 

Representation RDF d'un connecte 
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En XML, nous obtenons pour un connecte 



<rdf : Description about="http://www. phpsaloon.com/connectes/toto"> 
<connectes : photo> . . /i mg/none . png</connectes : photo> 
<connectes : pseudo>toto</connectes : pseudo> 

</rdf :Descri ption> 

A partir de la, nous pourrions definir une ressource « connectes » (au pluriel) 
en relation avec chaque connecte. Une telle methode manquerait cruelle- 
ment de lisibilite. RDF propose pour ameliorer les choses l'utilisation de 
conteneurs pour regrouper differentes descriptions (et done differents gra- 
phes) sous forme d'ensembles ou de listes. 

Pour PHP Saloon, la liste des connectes pourra done etre representee 
comme suit : 

<?xml version="1.0"?> 

<RDF:RDF xml ns : RDF="http://www.w3 .org/1999/02/22-rdf-syntax-ns#" 
xml ns :connectes="http://www. phpsaloon .com/#"> 
<RDF : Seq RDF : about="http : //www. phpsal oon . com/connectes"> 
<RDF:li> 

<RDF: Description RDF :about=" http://www.phpsaloon.com/connectes/ 

* stf"> 

<connectes : photo> . ./img/none . png</connectes : photo> 
<connectes : pseudo>Stf </connectes : pseudo> 
</RDF : Descri pti on> 

</RDF:li> 
<RDF:li> 

<RDF: Descri pti on RDF :about="http: //www. phpsaloon.com/connectes/ 

toto"> 

<connectes : photo> . . /img/none . png</connectes : photo> 
<connectes : pseudo>toto</connectes : pseudo> 
</RDF : Descri pti on> 

</RDF:li> 
</RDF:Seq> 
</RDF:RDF> 

C'est ce type de document que Mozilla va interpreter pour nous et utiliser 
pour peupler chacune des lignes de notre grille. 

Template et generation dynamique de I'interface 
utilisateur 

Ce mecanisme est designe sous le terme de template, qui, comme son nom 
l'indique, repose sur l'utilisation de patrons reproduits pour chaque element 
des sequences RDF. 



Reprenons de maniere expurgee la structure de notre document XML : 

<rows> 

<!-- premier connecte --> 

<row> 

<image width="64" height="64" src=". ./jean.png" /> 

<vbox> 

<label value="]ean" /> 
<label value="Paris" /> 

</vbox> 
</row> 

<!-- connectes suivants --> 

</rows> 

Nous devons dans un premier temps indiquer : 

• la source des donnees RDF qui sera utilisee ; 

• la ressource qui decrit les elements a parcourir, dans notre cas, la 
sequence des connectes. 

Ceci s'effectue au niveau de lelement rows. 

<rowsdatasources="connectes. rdf " ref="http://www. phpsaloon .com/ 
connectes" id="connectes"> 

<!-- ... --> 
</rows> 

Desormais, Mozilla sait qu'il va devoir construire le contenu de l'element 
rows a partir de notre fichier RDF. II reste a decrire le patron qui sera repro- 
duit. Le code suivant illustre la syntaxe retenue par Mozilla : 

<template> O 
<rule> Q 

<rowuri="rdf :*"> Q 

<image width="64" height="64" 

s rc=" rdf : http : //www . phpsal oon . com/#photo"/> 

<vbox> 

<label val ue=" rdf : http://www.phpsaloon.eom/#pseudo" /> Q 
<label val ue=" rdf : http: //www. phpsaloon. com/#age" /> 

</vbox> 
</row> 
</rule> 
</template> 

Lelement tempi ate designe le patron. Celui-ci peut etre compose de plu- 
sieurs regies © conditionnees ou non. Dans notre cas, le modele est tres 
simple, une seule regie de reproduction (inconditionnelle) est mise en oeuvre. 

Le contenu d'une regie est en tout point identique a du code XUL classique. 
La difference est que ce code va etre reproduit autant de fois que requis et 
certains parametres seront remplaces. 



L'attribut uri © de l'element row peut paraitre quelque peu barbare. En rea- 
lite, l'etoile indique, comme pour les expressions regulieres, que tous les ele- 
ments de la sequence sont acceptables (et vont done donner lieu a la creation 
d'un element row). 

La suite est evidente, les URI de la forme rdf :XXX vont etre remplaces par 
l'element correspondant de la description RDF. La encore, la syntaxe peut 
sembler etrange mais, en realite, il s'agit de la concatenation de l'espace de 
nommage connectes, utilise dans notre fichier RDF (http://www.phpsa"loon. 
com/#) et du nom de l'element dans la description (pseudo, age...). 

Apres avoir ajoute ce template au document XUL construit precedemment, 
nous obtenons le resultat presente en figure 9-11. Comme attendu, les deux 
connectes de la source RDF ont ete reproduits. Le rendu est identique a la 
version statique. Le moment venu, il suffira done de remplacer le fichier 
connectes . rdf par connectes . php et le tour sera joue. 
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Figure 9-11 Creation de ['interface par Mozilla a partir d'une source RDF 



Rafratchissement et securite 

Avant d'aborder ce dernier point (qui consistera a adapter nos feuilles de 
style XSL), il reste un probleme a prendre en compte : celui de la reactualisa- 
tion de la source de donnees. Ce point n'a rien d'epineux, Mozilla disposant 
des interfaces requises, mais il faut au prealable tenir compte des contraintes 
de securite. 



ASTUCE Modifier le niveau de securite 
de Mozilla (ou de Firefox) 

Mozilla propose une fonctionnalite, certes mer- 
veilleuse, mais evidemment pleine de risques. 
L'URL about :config donne en effet acces a la 
totalite des parametres de configuration, [.'inter- 
face utilisateur permet de rechercher dans les pre- 
ferences, par mots-cles, et les elements personnali- 
ses sont mis en gras pour davantage de lisibilite. 
L'element qui nous interesse est : 

si gned . appl ets . codebase_p ri nci pa~l_ 
support 

Pour acceder aux privileges nous concernant, il 
suffit de faire passer la valeur de false a true (cli- 
quez a cet effet sur la ligne en question, avec le 
bouton droit de la souris). 
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En effet, depuis le debut de ce chapitre, nous avons pu constater l'etendue 
des possibilites offertes par le framework Mozilla, RDF ajoutant encore a la 
richesse de celui-ci. On ne peut acceder a un tel niveau fonctionnel sans un 
minimum de precautions. Parmi celles-ci, l'interdiction faite aux documents 
XUL distants de manipuler directement les sources RDF, ce qui nous est 
pourtant necessaire pour la reactualisation. 

La encore, Mozilla propose plusieurs reponses : 

• la signature des applications distantes (dans notre cas, il s'agit de creer 
une archive de l'ensemble des documents et de la signer) ; 

• l'installation de cette archive en tant qu'application locale (Mozilla pro- 
pose un outil pour telecharger directement de telles extensions) ; 

• l'abaissement du niveau de securite de Mozilla. 
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Figure 9-12 Modification de la configuration de Mozilla 



Les deux premieres solutions sont naturellement preferables ; cependant, 
pour notre exemple, nous allons adopter la troisieme solution, facile pour 
quelques tests, et reversible. 

Une fois la securite adaptee, il devient possible de definir avec JavaScript une 
fonction refresh () laquelle, declenchee periodiquement, provoquera le 
rafraichissement de Tinterface et des sources de donnees. 



En void le code commente 



function refresh() { 
try { 

netscape . secu ri ty . P ri vi 1 egeManage r . enabl eP ri vi 1 ege( 

'UniversalXPConnect') ; 

} catch(e) { 

alert("Le niveau de securite en vigueur ne permet pas a\n"+ 
"PHP Saloon de fonctionner.\n"+ 

"Agissez ou vous serez deconnectes automatiquement !"); 



return ; 



} 



connectes = document. getElementByld('connectes') ; 

sources = connectes. database. GetDataSourcesO ; 
if (sources. hasMoreElements) { 
source = sources. getNext () ; 

} 

source = source. QueryInterface(Components. interfaces. 
* nsIRDFRemoteDataSource) 

source. Refresh (fal se) ; 
connectes. builder. rebuild() ; 
setTimeoutC refresh() ' , 15000); 



< Demande le privilege d'acceder a la totalite des 
possibility offertes par la plate-forme Mozilla. 



< En cas d'echec, informe I'utilisateur, les excep- 
tions JavaScript fonctionnant de maniere analo- 
gue a celles disponibles en PHP. 



Et nous en restons la. 



< Nous recuperons I'element rows designe par I'id 
connectes. 



Puis la liste des sources RDF.. 



Sous la forme d'une sorte d'iterateur. 



Nous utilisons la premiere source uniquement 
(normalement la seule). 



< A partir de I'objet generique, nous demandons 
I'interface specifique aux sources RDF distantes 
(ce qui nous serait refuse si la source n'etait pas 
une source RDF). 

< Cette interface nous permet d'appeler la 
methode ref reshQ de la source RDF. 



Cela fait, il suffit de demander a I'element rows 
de se reconstruire. 



La fonction sera re-appelee dans 1 5 secondes. 



Adaptation des transformations XSL 

Tout est desormais pret pour la connexion a la partie Controleur de PHP 
Saloon. Pour ce faire, nous allons : 

1 definir des feuilles de style adaptees (qui produiront le code RDF) ; 

2 modifier la vue pour que les navigateurs soient detectes et les feuilles de 
style correspondantes, utilisees. 
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Nouvelles transformations 

Ainsi, nous devons adapter la feuille de style connectes.xsl associee a la liste 
des connectes. Dans la version HTML, elle permettait de produire le sque- 
lette de la page HTML. Dans la mouture RDF, le principe reste identique 
et cette nouvelle version se contente de produire l'element racine du docu- 
ment RDF et la base de la sequence. 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<xsl : stylesheet version="1.0" 
xml ns : xsl="http : //www .w3 . org/1999/XSL/Transf orm" O 

xml ns : rdf="http : //www .w3 . org/1999/02/22- rdf- syntax- ns#" 
xml ns : connectes="http : //www . phpsal oon . com/#"> 
<xsl:output method="xml " indent="yes" encoding="iso-8859-l" /> Q 
<xsl : tempi ate match="/"> 

<rdf : rdf xml ns : rdf="http://www.w3 .org/1999/02/22-rdf-syntax-ns#" 
xml ns :connectes="http : //www. phpsal oon .com/#"> 
<rdf : Seq rdf : about="http : //www . phpsal oon . com/connectes "> 

<xsl :apply-templates /> 
</rdf :Seq> 
</rdf : rdf> 
</xsl : tempi ate> 

<xsl :include href="connecte.xsl" /> 
</xsl :stylesheet> 

On notera la presence de l'integralite des namespaces manipules ainsi que la 
modification de la nature du document de sortie qui passe d'HTML a XML Q. 

Ladaptation de la regie de transformation prevue pour chaque connecte n'est 
guere plus complexe ; RDF ne se preoccupe que des donnees, ce qui sim- 
plifie les transformations. 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<xsl : stylesheet version="1.0" 
xml ns : xsl="http : //www .w3 . org/1999/XSL/Transf orm" 

xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
xml ns : connectes="http ://www . phpsal oon . com/#"> 
<xsl:output method="xml" encoding="iso-8859-l" /> 
<xsl : tempi ate match="connecte"> 
<RDF:li> 

<RDF : Desc ri pti on RDF : about=" http : //www . phpsal oon . com/ 

*»connectes/{ ./pseudo}"> 

<connectes: photo 
<xsl :choose> 

<xsl :when test="normalize-space(. /photo) = ""> 
img/none.png 

</xsl :when> 
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<xsl :otherwise> 

<xsl :value-of select=". /photo" /> 
</xsl :otherwi se> 
</xsl :choose> 
</connectes : photo> 
<connectes:uid> 

<xsl :val ue-of select="@uid" /> 
</connectes:uid> 
<connectes : pseudo> 

<xsl :val ue-of select=" ./pseudo" /> 
</connectes : pseudo> 
<connectes :age> 

<xsl :val ue-of select=" ./age" /> 
</connectes:age> 

</RDF:Description> 
</RDF:li> 
</xsl : tempi ate> 
</xsl :stylesheet> 

Amelioration de la vue 

Apres avoir cree les nouvelles transformations pour Mozilla/XUL, il reste 
encore une petite adaptation. En effet, pour le moment, les classes vue utilisees 
ne se preoccupent pas de la nature du navigateur dont se sert le visiteur. Dans 
ce cas, aucune chance que les transformations specifiques ne soient appelees. 

Nous allons done definir deux nouvelles fonctions : 

• contenu_prefere() , 

• redi rect() . 

La premiere retourne le type de document prefere par le navigateur (XUL 
pour Mozilla, cHTML pour les terminaux i-mode, et HTML pour tous les 
autres). La classe vue peut alors etre modifiee pour que soit chargee la feuille 
de style la mieux adaptee : 

| $xsl->load(' style/' . contenu_prefere() . '/' ■ Sxslfile); 

La deuxieme redirige vers la page principale du site en fonction du type de 
contenu (par exemple site.xul ou site.html). Cette fonction est, entre 
autres, indispensable apres la phase d'identification. 

Ces quelques modifications apportees, l'utilisation de PHP Saloon avec 
Mozilla ou Firefox peut commencer, avec une interface propre. 



Figure 9-13 

Version finale de I'interface 
XULpour PHP Saloon 
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Finalisation de I'interface avec CSS 

Evidemment, I'interface obtenue n'est pas particulierement jolie. Une raison 
a cela : nous n'avons pour le moment applique aucun style. Comme pour 
tout le reste, Mozilla a adopte un standard bien connu du W3C : les feuilles 
de style CSS, nous restons done en territoire connu. 

Pour modifier l'apparence de chaque ligne, on pourra definir le style suivant : 
row { 

border-bottom: lpx solid darkgreen; 
margin-bottom: lOpx; 
color: darkgreen; 

} 

Ce precede est disponible pour l'integralite des elements XUL, y compris la 
fenetre principale : 

window { 

background: white; 

font-family: Verdana, Helvetica, Arial, Sans-Serif; 
font-size: 12px; 
color: darkgreen; 

} 

Dans la pratique, on aura interet a associer des classes aux elements XUL de 
maniere a ne pas changer l'apparence globale d'un element donne (par 
exemple button). 
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Apres ces quelques ajouts, notre PHP Saloon XUL a deja bien meilleure allure ! 



■ Bienvenue dans PHP Saloon! - Mozilla 
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Figure 9-14 

PHP Saloon XUL totalement operationnel 



En resume... 

Grace a notre architecture MVC et a l'utilisation d'XML, nous venons de 
definir une version totalement revue de PHP Saloon. Ce potentiel est claire- 
ment le fait de PHP 5 qui stabilise les API XML/XSL et ouvre ainsi a la 
communaute PHP les portes de l'univers XML. Naturellement, ce qui vient 
d'etre realise pour PHP Saloon est transposable a des applications plus com- 
plexes. En entreprise, on pourra ainsi assurer l'interoperabilite avec 
l'ensemble des elements du systeme d'information et definir des interfaces 
diverses, riches avec un client lourd comme Mozilla sur le poste de travail 
interne, allegees pour les mobiles, ou HTML pour l'extranet. Tout cela avec 
un minimum d'effort et dans un cadre davantage propice a la qualite et a 
l'exploitation des developpements. 



Version i-mode allegee 



Avec la version XUL de PHP Saloon, nous avons 
precede a une refonte en profondeur de l'apparence. 
Une modification aussi importante n'est pas toujours 
necessaire. Ainsi, en proposant une version i-mode, 
il ne sera plus question de la richesse de l'interface mais 
de son adequation a un terminal mobile. II faudra done 
simplifier a l'extreme et tirer profit des astuces 
ergonomiques de la plate-forme cible. 



SOMMAIRE 

Definir les contraintes 

► Adapter les feuilles de style 
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► Cookie 
session id 



ALTERNATIVES Wap ou i-mode 



Pour PHP Saloon, nous avons fait le choix d'i- 
mode, choix guide par la simplicity et par le dyna- 
misme d'une plate-forme aujourd'hui portee par 
un ratio d'utilisation superieur a celui disponible 
sur les telephones Wap. 

Simplicity avec un cHTML, dans la droite ligne 
d'HTML, meme si la version 2.0 de WML (WAP) 
corrige les erreurs de jeunesse et simplicity tou- 
jours avec un support facilite des terminaux. 
Mais ne nous leurrons pas. Que ce soit i-mode ou 
Wap, notre methode de travail est adaptable aux 
deux. Pour creer une version Wap de PHP Saloon, il 
suffira d'adapter les feuilles de style XSLT comme 
pour i-mode, ni plus ni moins. 



POUR PLUS D'INFORMATIONS 
Le guide de developpement i-mode 

Pour obtenir le detail des elements HTML pris en 
charge et les contraintes qui s'appliquent a la 
plate-forme i-mode, un guide est disponible a 
I'attention des developpeurs. 

> http://communaute.imode.fr 



Contraintes et propositions pour une 
utilisation mobile 

Avec XUL et Mozilla, nous avons repondu a une exigence : utiliser au mieux 
le potentiel disponible sur la plate-forme de l'utilisateur de PHP Saloon. 
Utiliser l'espace, avec les onglets, pour une meilleure presentation des listes 
et des messages ; organiser l'interface pour integrer les possibilites habi- 
tuelles et reconnues des systemes modernes et qui depassent tres largement 
celles du Web et du langage HTML. 

Notre exigence avec cette version i-mode demeure inchangee. II s'agit tou- 
jours d'occuper au mieux l'espace et de tirer profit de la plate-forme client, 
mais dans ce cas, les contraintes vont etre diametralement opposees. 

Les contraintes physiques 

La oil l'ecran d'un ordinateur fixe aurait pu paraitre trop grand pour PHP 
Saloon, l'ecran d'un telephone mobile va clairement poser probleme. Les 
dimensions standards pour ce type de terminal font etat de 120 pixels de lar- 
geur pour 160 pixels de hauteur. II va sans dire que notre approche initiale a 
base de frame est incompatible avec ce type d'ecrans. 

Autre contrainte, celle d'un support restreint du langage HTML et de ses 
extensions. II n'est plus question alors d'utiliser CSS ou JavaScript, ce qui 
entraine les deux consequences suivantes : 

• Les transformations devront integrer l'ensemble des options de mise en 
page (par chance fort limitees). 

• Le rafraichissement de l'information ne pourra etre realise de maniere 
automatique ; il faudra done prevoir un moyen pour le provoquer 
manuellement. 

Ce dernier point peut paraitre totalement anodin mais il s'avere fort judi- 
cieux, compte tenu de la faible bande passante disponible, meme si un des 
corollaires de cette contrainte est de devoir trouver la place pour un bouton 
supplementary. 

Le support du langage HTML lui-meme est reduit a un sous-ensemble 
(NTT Docomo, l'inventeur d'i-mode l'a nomme cHTML). Cependant, les 
balises cles utilisees dans PHP Saloon sont presentes, et compte tenu des 
faibles possibilites de mises en page, l'ensemble est tres suffisant. 

Cependant, la encore, il faudra integrer une caracteristique limitative : 
l'absence de clavier et de souris. Pour pallier ce dernier point, cHTML 
definit une methode permettant d'associer un lien a certaines touches du 
clavier. 
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Derniere contrainte, le navigateur i-mode embarque dans les terminaux ne 
gere qu'une sous-partie du protocole de transport HTTP. II faudra done 
nous passer des cookies et gerer les sessions autrement. 

Tableau 10-1 



Contrainte 


Consequence 


Faible tail le de I'ecran 


Frame impossible : prevoir une navigation 
entre les trois parties de I'application. 


Pas de JavaScript 


Prevoir un bouton ad hoc pour le rafraichisse- 
ment des listes, par exemple. 


Pas de clavier ni de souris 


Utiliser les raccourcis proposes par cHTML 
pour activer les liens plus rapidement. 


Pas de cookies 


Gerer les sessions sur I'URL. 



Elements d'adaptation pour PHP Saloon 

Malgre l'importance apparente de ces contraintes, peu de modifications de 
fond seront necessaires. En ce qui concerne les pages d'inscription et de con- 
nexion, notre mise en page actuelle est acceptable en l'etat, pour peu que Ton 
se contente de la partie centrale (voir figure 10-1). Quant au cas particulier 
de l'inscription, il faudra toutefois se passer de photographie, impossible a 
telecharger simplement, depuis un terminal mobile. 
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Figure 10-1 Adaptation des pages d'inscription et de connexion 



CULTURE LesEmoji 

Les pictogrammes i-mode ne sont rien d'autre que 
de petites images toutes simples. Elles ont cepen- 
dant un avantage. Disponibles directement dans le 
terminal mobile, elles ne requierent ni transfert ni 
ressources pour etre affichees et peuvent consti- 
tuer un moyen simple d'alleger les pages, comme 
c'est le cas, dans PHP Saloon, pour la navigation. 
La liste de ces pictogrammes est disponible en 
telechargement sur le site officiel d'i-mode en 
France. 

► http://communaute.imode.fr 



Bien entendu, l'utilisation des frames sur la page principale impose de revoir 
certaines choses mais, la encore, il n'est pas question de tout bouleverser de 
fond en comble. 

Nous avons trois scripts importants : 

• liste des connectes ; 

• liste des amis ; 

• echange et envoi de message. 

Dans la mesure ou ces trois elements ne sont plus affichables simultanement, 
nous allons ajouter a chaque transformation XSLT la production d'un menu 
de navigation. Ce menu (voir les figures 10-2 et 10-3) permettra de passer 
d'une page a l'autre. 




Figure 10-2 Reorganisation de I'interface et des listes de connectes 
Ce meme menu integrera le lien de rafraichissement. 

Pour gerer les raccourcis sur ces liens, nous nous servirons de la methode 
proposee dans le guide de developpement i-mode en associant a chaque lien 
une accesskey (cet attribut est d'ailleurs tout a fait exploitable en HTML 4). 
Le plus simple est alors d'associer les touches 1, 2 et 3 a chaque lien. Dans 
cette hypothese, la touche 1 permet alors de basculer en permanence de la 
liste des amis a la liste complete des connectes. Afin de clarifier davantage 
les choses, nous allons suivre les conventions proposees et ajouter dans les 
liens les Emoji (pictogrammes i-mode) correspondants. 
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Figure 10-3 Envoi de message dans PHP Saloon i-mode 



Pour les sessions, malgre les reserves emises au chapitre 6, nous utiliserons le 
support integre de PHP favorisant le transport de l'identifiant de session sur 
l'URL en lieu et place des cookies. Celui-ci est le plus souvent active par 
defaut chez les hebergeurs, il faudra done veiller a conserver des URL de 
longueur raisonnable. Pour i-mode, cette longueur maximale est en effet 
fixee a 200 caracteres. 



Adaptation des feuilles de style 

Notre route est tracee : il faut maintenant mettre les decisions en pratique. A 
defaut de telephone i-mode, vous pourrez tester le resultat des modifications 
en utilisant l'excellent simulateur Wapag. 

Nous allons operer sur deux fronts : 

1 une simplification drastique du code HTML produite par les 
transformations ; 

2 l'ajout systematique du menu de navigation aux scripts de la page princi- 
pale utilisee dans la version classique. 

Le premier point se regie de maniere brutale, on pourrait presque dire « a la 
hache ». Ainsi, si Ton prend comme exemple le code de la page d'identifica- 
tion, le resultat est eloquent. 



OUTIL Wapag 



Wapag est un outil de simulation i-mode utilisable 
directement en ligne pour effectuer quelques tests. 
Le rendu est la plupart du temps fiable meme si 
celui-ci est realise en grande partie avec des 
feuilles de style CSS. 

► http://www.wapag.com/en/simulation.html 
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Regie de transformation standard 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<xsl : stylesheet version="1.0" 
xml ns :xsl=" http://www.w3 .org/1999/XSL/Transfo rm"> 
<xsl : tempi ate match="/"> 
<html> 
<head> 

<title>Bienvenue dans PHP Saloon!</title> 
<link rel="stylesheet" 

href ="style/style. ess" type="text/css" 
</head> 
<body> 

<div align="center"> 

<div align="left" style="width : 200px;"> 
<f ieldset> 

<legend> 

<img src="img/phpsaloon.gif" 
alt="Logo PHP Saloon"/> 

</legend> 

<div class="innerdiv"> 

<xsl :apply-templates /> 

</div> 

</f ieldset> 
</di v> 
</di v> 
</body> 
</html> 
</xsl : tempi ate> 
</xsl :stylesheet> 



/> 



Regie simplified pour les terminaux i-mode 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<xsl :stylesheet version="1.0" 

xml ns : xsl="http : //www .w3 . org/1999/XSL/Transf orm"> 
<xsl : tempi ate match="/"> 
<html> 
<head> 

<title>Bienvenue dans PHP Saloon!</title> 
</head> 

<body text="#00b600" link="#b60000" 
vlink="#b60000"> 
<img src="img/phpsaloon-petit .gif"/> 

<xsl :apply-templates /> 
</body> 
</html> 
</xsl :template> 
</xsl :stylesheet> 



Globalement, il faudra proceder de la mime fafon pour l'immense majorite 
des regies de transformation. Le resultat obtenu est visualisable avec Wapag 
(voir figure 10-4). 




Figure 10-4 Simulation de la page de connexion sur un terminal Nec 
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Pour la liste des connectes et celle des amis, tout comme pour l'envoi d'un 
message, il faudra proceder de maniere identique, en prenant soin d'ajouter 
le menu evoque precedemment (point 2). 

Pour le realiser, nous irons au plus simple : trois liens separes par le tradi- 
tionnel « | ». Cette methode, simple et efficace, est souvent utilisee, meme 
pour les pages classiques. 

Chaque lien comportera deux Emoji : 

1 le numero de la touche utilisable pour valider le lien ; 

2 un pictogramme signifiant le plus precisement possible le role du lien. 

Une page HTML statique peut etre utilisee pour tester le resultat avant 
d'incorporer le tout dans nos transformations. 

<center> 

 <a href="#"></a> | 
 <a href="#"></a> | 
 <a href="#"></a> 
</center> 

Une fois valide (voir figure 10-5), ce code doit etre incorpore dans les trans- 
formations utilisees par les listes de connectes. On obtient alors l'ecran pre- 
sents en figure 10-6 et un PHP Saloon, version i-mode, desormais fonc- 
tionnel sur cette nouvelle plate-forme. 



A RETENIR Identifier la plate-forme 

Un des avantages de la plate-forme i-mode est de 
fixer un cadre qui peut certes paraTtre tres contrai- 
gnant, mais qui permet de developper une applica- 
tion web avec la garantie qu'elle fonctionnera sur 
I'ensemble du pare de terminaux. 
Pour PHP Saloon, nous allons done nous contenter 
de detecter la banniere i-mode au sein de I'en-tete 
USER-AGENT sans nous preoccuper de la nature 
exacte du terminal utilise. 
En France, comme dans de tres nombreux pays, le 
type de navigateur communique est portal mmm. 
Cette indication nous suffit pour detecter un termi- 
nal i-mode. 




Figure 10-5 Exemple de menu de 
navigation dans PHP Saloon i-mode 



En resume... 

Le recours aux transformations XSLT nous permet de beneficier d'une tres 
grande liberte, qu'il s'agisse de proposer des interfaces complexes, pour une 
utilisation sur un client lourd en entreprise, ou tout au contraire, des inter- 
faces allegees pour l'utilisation mobile, par exemple sur un PDA, comme 
nous venons de le faire. En outre, et meme si ce dernier point n'a pas ete 
experimente pour PHP Saloon, ces transformations favorisent egalement la 
creation de ponts vers d'autres applications, pour mettre en oeuvre des outils 
de « single sign on » (authentification unique) ou d'echanges entre parte- 
naires. On le voit, derriere une apparente complexite, le duo XML/XSL 
livre un potentiel tres eleve, en termes de richesse fonctionnelle comme en 
amelioration des couts de maintenance et d'exploitation. 
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Figure 10-6 Affichage de la liste 
des connectes (version i-mode) 
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Protection des images et 
operations graphiques avec GD 



Avec les transformations XSL nous n'avons manipule 
que des documents texte. Mais PHP dispose aussi 
d'un large eventail d'extensions pour creer ou modifier 
des documents binaires tels que les images 
ou des fichiers PDF. 

Grace a la bibliotheque GD, nous exploiterons ces 
possibilites pour proteger de tout detournement les 
photos des utilisateurs de PHP Saloon. 



SOMMAIRE 

► Problematique 
Aperqu de GD 
Traitement des images 

MOTS-CLES 

Watermarking 
AlphaBlending 

► GD 



A RETENIR GD, standard du moment 

GD est disponible au sein de PHP depuis les debuts 
du langage. De nombreux exemples sont disponi- 
bles pour vous aider a en tirer profit. 
L'ensemble reste neanmoins perfectible et I'avene- 
ment de PHP 5 devrait etre I'occasion de mieux 
integrer GD a PHP, et pour de nombreux projets 
d'atteindre une certaine maturite. 



Jusqu'a present, l'utilisation de notre couple infernal XML/XSLT a pu 
laisser penser que seuls les documents texte etaient manipulables avec PHP. 
II n'en est rien, naturellement. 

Tout d'abord, ainsi qu'evoque precedemment, les transformations XSL peu- 
vent produire des documents binaires via FO (Formating Objects). Enfin, et 
c'est tout l'objet de ce chapitre, PHP lui-meme dispose d'extensions capa- 
bles de manipuler directement les documents binaires, qu'il s'agisse de modi- 
fier des documents existants ou de les creer de toutes pieces. 

Dans ce chapitre, nous allons nous interesser plus particulierement a l'exten- 
sion GD (GD etant une librairie graphique). Cependant, PHP est particulie- 
rement riche en la matiere. II est ainsi possible de creer des documents PDF 
pour ameliorer le rendu imprime et la transportabilite des informations. 



Problematique 



COMPRENDRE Responsabilite 
de I'auteur du site 



Avant de faire un site Web, il faut etre conscient du 
role que Ton endosse implicitement : celui de 
directeur de publication. Et done, pour les aspects 
les plus facheux, le role de responsable des conte- 
nus. 

La loi est precise sur divers points quant a I'eten- 
due de ce role, en matiere de respect du droit 
d'auteur, ce qui est probablement le plus simple a 
gerer, mais aussi en matiere de controle des conte- 
nus emis par les visiteurs du site ou diffuses par 
I'intermediaire de celui-ci. Mais ceci est une toute 
autre gageure. 



Pour egayer la liste des connectes et faire de PHP Saloon un lieu d'echange 
plus convivial, chaque utilisateur peut telecharger la photographie de son 
choix. Celle-ci lui sera alors associee dans ses echanges avec les autres con- 
nectes. Cette fonctionnalite apparait de prime abord completement anodine. 

Deux ecueils peuvent pourtant rapidement donner des sueurs froides au ges- 
tionnaire du site : 

1 La legalite des photos utilisees n'est en rien assuree par defaut. 

2 Le detournement par des tiers, des photos deposees, est toujours possible. 

Le premier point ne connait (helas !) aucune solution technique ; il appar- 
tient done a l'administrateur en charge du site de verifier jour apres jour 
qu'aucune photo manifestement illicite ne se soit glissee parmi les autres. 
Une possibilite consiste a n'integrer les photographies des membres qu'apres 
une verification manuelle prealable. 

Le deuxieme point, quoique peut-etre moins evident ou moins mis en avant, 
est pourtant tout aussi redoutable. Certaines photos peuvent tout simple- 
ment etre reutilisees a l'insu de leurs proprietaires sur d'autres sites, voire 
dans certains documents commerciaux. 

Pour resoudre ce probleme, et eviter que les membres de PHP Saloon ne se 
retrouvent sans le savoir, acteurs a succes de publicites douteuses, nous allons 
nous servir des capacites graphiques de l'extension GD disponible dans PHP. 
Nous allons mettre en oeuvre une technique en realite tres simple et connue 
sous le terme de « watermarking ». Lidee de base est equivalente a celle du 
filigrane. Nous allons ajouter systematiquement sur chaque image un ele- 
ment en filigrane qui indiquera de maniere indiscutable la provenance de la 
photo, la rendant inexploitable pour tout fraudeur. 



198 



Decouverte de GD 



GD est un compagnon historique de PHP ; une version des sources de la 
librairie est meme incluse dans sa distribution, ce qui permet aujourd'hui de 
disposer de ressources importantes sur le sujet. Pour notre part, nous allons 
nous contenter d'effleurer ce theme, la documentation officielle de PHP lis- 
tant de maniere exhaustive les possibilites de la librairie. II ne faut done pas 
hesiter a s'y reporter, d'autant que les commentaires des utilisateurs sont tres 
souvent precieux quant aux subtilites de GD. 



GD aussi 



Les utilisateurs habitues a PHP 4 ne doivent pas 
s'attendre a un bouleversement en matiere de trai- 
tement d'image. Les successeurs de GD ne sont 
pas prets, et la librairie poursuit son integration 
dans PHP. 



Principes (('utilisation 

Nous allons explorer un cas d'ecole typique d'une utilisation de GD avec 
PHP. Nous verrons un peu plus loin que, pour PHP Saloon, les choses sont 
encore plus simples. 

Notre exemple de prise en main consiste tout simplement a : 

• creer une image de toutes pieces ; 

• y ajouter differents elements graphiques (dans la pratique, il pourrait 
s'agir de diagrammes, de camemberts...) ; 

• delivrer directement l'image au navigateur. 



CONFIGURATION Disponibilite de GD 

Dans la plupart des cas et notamment chez les heber- 

geurs, GD est directement integree dans PHP (un 

phpi nf o() peut permettre de s'en assurer). 

II peut etre parfois necessaire de charger I'extension 

avant de commencer a I'utiliser en s'aidant de I'instruc- 

tiondlO. 

dl('gd'); 
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Plusieurs versions de GD coexistent parfois sur les syste- 
mes sans parler de la version incluse dans la distribution 
PHP. Au final, il est parfois difficile de connaTtre precise- 
ment I'etendue des fonctionnalites disponibles (on pense 
notamment au support des images GIF, retire pour cause 
de brevet), ou encore au support de certains formats 
d'image (PNG, JPEG) ou des polices « True Type » qui 
dependent chacune de librairies externes. 
Dans ce cas, il est possible de s'assurer que les operations 
utilisees sont disponibles, en ayant recours a la fonction 
get_extension_funcs() qui permet de connaTtre les 
fonctions rendues disponibles par une extension. 

php -r 'get_extension_funcs("gd") ; ' 



GO Support 


enabled 


00 VeislMi 


bunaiea (2.0.1 7 compatible) 


GIF Read Support 


enabled 


JPG Support 


enabled 


PNG Suppon 


BrtaMed 


WBMP Support 


enabled 


XBM Support 


enabled 


libxml 



Figure 11-1 Verification de I'activation de GD dans PHP avec phpinfoQ 



199 



Creation de I'image 



Definition des couleurs 



Avant de renvoyer le code de I'image au naviga- 
teur du visiteur, il faut fixer le type de contenu. 
GD comporte une table de correspondance qui 
dispose du type MIME requis a partir des cons- 
tantes simples utilisees. 



Cette fonction produit tout le code de I'image. 



Juste une histoire de menage 



Attention a ne pas laisser de lignes vides apres 
?>, pas meme un simple retour a la ligne, sinon 
le contenu de I'image serait corrompu ! 



Figure 11-2 

Image creee dynamiquement avec GD 



Quelques operations graphiques elementaires ► 
sont mises en ceuvre. Le chiffre 5 designe I'une 
des cinq polices de caracteres integrees a GD, 
mais il est cependant possible de telecharger des 
polices additionnelles (dans ce cas, on utilisera 
plutot les fonctions dediees aux polices « True 
Type »). 



Les fonctions de GD commencent toutes, en general, par image et en depit 
de leurs noms a rallonge, il ne faut pas y voir de complexite particuliere. 

Premiere confrontation a GD 

<? 

$img = imageCreateTrueCo~lor(400,400) ; 

$red = imageCo~lorA~l~locate($img, 255, 0, 0); 
Swhite = imageCo~lorA~l~locate($img, 255, 255, 255); 
Sgray = imageColorAllocate($img , 200, 200, 200); 

imagefm ($img, 0,0, Sgray); 

imagefilledellipse($img, 200,200, 300, 200, Swhite); 
imagestringCSimg, 5, 150, 195, "PHP Saloon!", Sred); 



header('Content-type: ' . image_type_to_mime_type(IMAGETYPE_]PEG)) ; 



image]PEG($img) ; 
imageDestroy($img) ; 
?> 



tcstgtl.php (JPEC Image, 400x400 pixels) Mozilla 
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Integration des images dans les pages web 
traditionnelles 

Cette image est loin de constituer une oeuvre d'art, c'est certain (voir figure 
11-2). Mais comme toutes les images creees a partir de PHP ou statiques, 
elle peut etre integree dans des pages web de maniere tout a fait classique. 
Le code ci-dessous permet de s'en assurer (voir figure 11-3). 

<htm~l> 
<head> 

<titfe>Test de GD</title> 
</head> 

<body background="red"> 

<hl>Voici une image generee</hl> 
<center> 

<img src="testgd.php"> 
</center> 
</body> 
</htm"l> 
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Voici une image generee 








o 






Done 









Figure 11-3 Integration de I'image GD dans une page Web 



METHODE Authentification 
et generation d'images 

Dans cet exemple, nous ne nous sommes pas pre- 
occupes de la gestion des droits. Nous avons 
genere une image, et c'est tout. 
Ce point particulier constitue un oubli classique, et 
il en resulte une faille de securite importante, puis- 
que des informations sont alors accessibles, en 
dehors de tout controle. 

II faut done, dans tous les cas, prevoir de controler 
le droit d'acces (via le cookie de session par exem- 
ple) et, le cas echeant, produire une image 
d'erreur. 
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Chargement de I'image originale 



Puis chargement du filigrane 



Recopie de I'image d'origine, redimensionnee si 
necessaire 



Ajout du canal Alpha 



Superposition du filigrane a I'image d'origine 
(eventuellement au milieu de celle-ci si aucun 
redimensionnement n'a eu lieu). 



Production de notre icone 



Nettoyage de tout ce qui ne sert plus a rien. 



Traitement des photos confiees a PHP 
Saloon 

Le traitement requis pour PHP Saloon est a peine plus complexe que notre 
image de demonstration, juste un peu plus technique. 

Nous allons realiser une fonction qui va apporter plusieurs modifications a 
I'image telechargee par l'utilisateur : 

1 normaliser sa taille selon un gabarit donne (64 x 64 pixels) ; 

2 ajouter un filigrane en transparence. 

Vbici le code resultant, oil trois parametres au minimum sont requis : 

• I'image d'origine (elle sera telechargee par le connecte a PHP Saloon) ; 

• I'image a produire ; 

• le filigrane. 

Par defaut, notre fonction redimensionnera I'image originale selon le format 
du filigrane (pour PHP Saloon, il est prevu 64 x 64 pixels). Si le quatrieme 
parametre est place a false, alors le filigrane est positionne au milieu de 
I'image d'origine dont le format a ete conserve. 

function watermark($srcfi lename, Snewname, Swatermark, 
Sresize = true) { 

Sphotolmage = 

i mageCreateFromSt ri ng(f i 1 e_get_contents($s rcf i 1 ename) ) ; 

Slogolmage = ImageCreateFromPNG($watermark) ; 

if (Sresize) { 

Sicone = imagecreatetruecolor(imagesx($logoImage) , 

imagesy($~logoImage)) ; 
imagecopyresized($icone, Sphotolmage, 0, 0, 0, 0, 
imagesx($logoImage) , imagesy (Slogolmage) , 
imagesx($photoImage) , imagesy($photoImage)) ; 
} else 

Sicone = Sphotolmage; 

ImageAlphaBlending($icone, true) ; 

ImageCopy($icone, Slogolmage, 

max((imagesx($icone) - imagesx(SlogoImage)) / 2,0), 
max((imagesy($icone) - imagesy($logoImage)) / 2,0), 
0, 0, imagesx($logoImage) , imagesy($logoImage)) ; 

Image]PEG($icone, Snewname) ; 

ImageDestroy($photoImage) ; 
ImageDestroy($logoImage) ; 
if (Sresize) 
ImageDestroy($icone) ; 
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Nous utilisons astucieusement la fonction imageFromStringO pour ne pas 
avoir a nous soucier du type de l'image (sinon il aurait fallu tester le type de 
l'image nous-meme, puis appeler les fonctions GD ad hoc, comme 
imageFrom]PEG() ou imageFromPNGO). 

Enfin, il nous reste un dernier point a examiner, pour ceux qui s'interrogent 
sur ce mysterieux « alpha blending ». II s'agit en realite d'ajouter un canal 
pour la transparence (comme il en existe pour les couleurs rouge, verte et 
bleue). Ceci fait que toutes les operations graphiques vont correctement 
integrer les transparences presentes dans les images. 

On notera au passage que le resultat final repose sur le fait que l'image uti- 
lisee pour le watermarking dispose de zones transparentes (ce qui est permis 
de maniere performante dans les images PNG), faute de quoi la copie serait 
opaque et notre image de depart, entierement recouverte par le filigrane. 
Dans cet exemple, l'image utilisee est creee avec Gimp (voir a la figure 11-4 
oil un fond blanc a ete ajoute, afin de rendre le filigrane visible). 
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Figure 11-4 Creation du filigrane dans Gimp 

On s'aperfoit par ailleurs que « filigrane » est un terme abusif, car il s'agit en 
realite de superposition, toute l'illusion reposant sur la transparence. 

Notre fonction doit etre ajoutee a la phase d'inscription. Elle operera sur 
l'image transmise via le formulaire de cette page, mais il est evidemment 
possible d'effectuer quelques tests immediatement, comme le montrent les 
figures 11-5 et 11-6. 



GD et les images GIF 



Nous avons cree notre filigrane avec une image 
PNG parfaitement adaptee au traitement de la 
transparence. Une image GIF aurait pu etre utilisee 
aussi, cependant le support des images GIF est 
rarement present dans GD en raison d'un pro- 
bleme de brevet, et, Ton s'en doute, de redevance. 
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Figure 11-6 Image apres watermarking 
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En resume 



L'utilisation de GD au sein de PHP est caracteristique d'un large eventail 
d'extensions disponibles, qui permettent a PHP d'acceder a des ressources 
externes, qu'il s'agisse de fichiers image comme pour GD, ou de base de 
donnees, ce qui est le cas avec SQLite. Ces extensions donnent acces a des 
composants developpes, le plus souvent, en C ou en C++ sans etre confron- 
tees a la complexite de l'interface de programmation par defaut : PHP joue 
ainsi parfaitement son role de langage glu. 
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I nternational isation 



L'internationalisation d'une application web apporte 
souvent la derniere touche professionnelle et peut 
s'averer indispensable dans bien des cas pour toucher 
l'integralite du public vise. 

Nous verrons comment internationaliser PHP Saloon 
en explorant l'eventail de possibilites offertes par PHP 
bien sur, mais aussi par le serveur web Apache grace 
aux informations disponibles via le protocole HTTP. 



SOMMAIRE 

Internationaliser 

Solutions apportees par HTTP 

► Possibilites de PHP 

MOTS-CLES 

► Multiviews 

► Locale 

► Gettext 

► Accept language 



Internationaliser PHP Saloon ? 



COMPRENDRE 
Les langues selon I'lSO et le W3C 

La plupart du temps les differentes langues ne 
seront pas designees par leur nom (d'ailleurs dans 
quel langue ce nom devrait-il etre exprime ?) mais 
de maniere codee, avec deux lettres. Dans la plu- 
part des cas ces lettres correspondent aux initiales 
du pays racine de la langue : FR pour le frangais, 
EN pour I'anglais. Toutefois ('attribution n'est pas 
toujours aussi limpide, I'lSO maintient une liste 
normative de ses correspondances. 
En outre, chaque langue est susceptible de dispo- 
ser de variantes. Pour le frangais, il peut s'agir des 
adaptations quebecquoises, suisses ou encore bei- 
ges. Pour I'anglais, on peut citer I'anglais ameri- 
cain. Dans ce cas la notation utilisee consite a 
completer le code initial par un deuxieme code : 
FR-CA ou EN-US, par exemple. 
Dans certains cas, on pourra egalement preciser 
I'ensemble par le type de codage utilise pour les 
caracteres (ISO-8859-15 pour I'Europe occidentale 
par exemple). 

► http://www.faqs.org/rfcs/rfc1 766 

► http://www.w3.org/WAI/ER/IG/ert/iso639.htm 



Dans les chapitres precedents nous avons porte une attention toute particuliere 
a l'accessibilite, a l'adaptation de PHP Saloon, aux differents types d'utilisa- 
teurs et de terminaux. Toutefois, cet effort ne serait pas complet si l'application 
ne devait au final proposer que le francais au niveau de l'interface utilisateur. 

En effet, meme pour un outil plutot classe dans la categorie loisirs, Internet 
est ainsi fait que des utilisateurs du bout du monde vont essayer l'application, 
parce qu'un moteur de recherche leur aura propose la page, parce que PHP 
Saloon est un moyen d'entrer en contact avec des utilisateurs francophones. 

Cette realite est transposable tres rapidement pour les applications commer- 
ciales et les sites d'entreprises, y compris pour les PME et Ton pourrait 
meme dire surtout pour les PME qui disposent en general d'un savoir faire 
particulier dans leur metier et dont la production peut satisfaire des besoins 
au-dela des frontieres nationales. 

Comme pour chaque chose, internationaliser n'est pas gratuit, d'une part 
nous allons le voir, l'application doit se preter a cette transformation, et 
enfin, sauf a disposer d'un interprete, la traduction de l'environnement utili- 
sateur en lui-meme requiert des ressources exterieures. Sur ce point il faut 
admettre que la nature repartie des projets Open Source donne souvent un 
avantage competitif non negligeable, l'intervention de la communaute per- 
mettant de disposer rapidement de sites et de logiciels dans plusieurs lan- 
gues. Un argument « marketing » important qui agit tant sur la visibilite que 
sur l'attrait du logiciel. 

Pour PHP Saloon nous allons porter notre effort a deux niveaux. D'une part, 
en tirant parti de notre plate-forme web (avec Apache), et, d'autre part, en 
utilisant un grand standard de la galaxie GNU fort heureusement disponible 
dans PHP sous forme d'extension. 



Determiner les attentes du visiteur et 
reagir avec HTTP et Apache 

Nous allons done internationaliser, mais encore faut-il avoir une idee des 
desiderata de l'utilisateur. L'objectif etant naturellement de ne pas obliger 
celui-ci a selectionner manuellement sa langue de predilection apres avoir 
subi l'affichage d'une page par defaut selon toute probabilite incomprehen- 
sible pour lui. 

Quiconque a deja eu la malchance d'experimenter des sites japonais ou russes a 
sans nul doute ete confronte a la penible et approximative recherche du lien 
vers la version anglaise pour tenter de retomber sur un discours plus abordable. 
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Decouvrir les preferences des utilisateurs 

Par chance le protocole HTTP a tout prevu. 

Lors de notre exploration des sessions, nous avons deja pu observer que les 
echanges entre un navigateur et le serveur web ne se limitent pas a une 
sequence de questions/reponses. Tant le navigateur que le serveur web preci- 
sent leurs echanges avec des informations additionnelles, les fameux en- 
tetes, dont le cookie naturellement. 

Les preferences de l'utilisateur en matiere de langues vont transiter jusqu'au 
serveur web de facon identique. Le navigateur, en fonction de la version ins- 
tallee, des preferences adoptees par l'utilisateur et stockees dans sa configu- 
ration va transmettre une information precise qu'il appartiendra au serveur 
web d'exploiter... ou non. 

De prime abord le format de ces en-tetes est simple. Ainsi pour indiquer que 
la langue preferee de l'utilisateur est le francais votre navigateur envoie tres 
probablement un en-tete voisin de celui-ci : 

Accept-Language: fr 

Les choses se compliquent ensuite legerement, car definir une langue favorite 
est une chose, mais preciser les autres langues acceptables en est une autre. 

Pour cela, i'en-tete Accept-Language va se decomposer en plusieurs elements 
separes de « , ». Chaque element est dedie a une langue et comporte un coef- 
ficient qui precise le niveau de preference de la langue en question. Ainsi, 
l'en-tete suivant : 

Accept-Language: f r,en-us;q=0.7,en;q=0.3 

precise que l'auteur de cet ouvrage prefere les documents exprimes en fran- 
cais, l'absence de coefficient donnant de fait la plus forte priorite au francais, 
puis ceux exprimes en anglais, dans la variante americaine, mais avec une 
priorite moindre, les documents en pur style anglais. 

Pour avoir une idee plus precise de la configuration de votre navigateur, il est 
possible de retrouver ses en-tetes dans le tableau super global $_SERVER dis- 
ponible en PHP. Ce tableau est en outre affiche avec l'instruction phpinfo(), 
voir figure 12-1. 



E 
2 



PHP Variables 





V.ii i.ihle 




_SERVER|'DOCUMENT_ROOT"] 


iVar/www 


_SERVER|"HTTP_ACCEPT"] 


texttoml.application/xml.application/xhtml+xml.text/html 


_SERVER|"HTTP_ACCEPT_CHARSET"] 


ISO-BB59-1,utf-B;q=0.7,*;q=0.7 


_SERVER|"HTTP_ACCEPT_ENCODING"] 


gzip, deflate 


^= : ,',= : .i.!,.,J^.=J*li;WI!:Wiil 




_SERVERI"HTTP_CONNECTION") 


keep-alive^ 



Figure 12-1 

Verification des preferences du navigateur 
a I'aide de phpi nfo() 
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A RETENIR Modifier ses preferences dans Internet Explorer et Mozilla 

Chaque navigateur est livre avec un certain nombre de parametres Cependant, dans tous les cas, ce parametre peut etre modifie et 
prefixes, c'est le cas notamment de la langue preferee le plus sou- affine. Pour Mozilla et Internet Explorer la configuration n'est pas 
vent en relation directe avec la langue choisie lors de I'installation. tres compliquee et peut etre ponctuellement modifiee. 



Avec Internet Explorer : 

Q Ouvrir 
les options 
Internet 



1 'Sab out: blank Microsoft Internet Explorer 


Firhi*r Rditinn Affichag* Favoris 


Outils ? 


1 1 4- Pn*e«P« * (& g) ^fMMa ^ 


Courtier ct News ► 






Synchroniser 
Windows Up dak 






Afficher les liens opparcntes 
VisualRoute Trace 






Options Internet... 











© Modifier les 
priorites ou les langues 
preferees 



Certains sites Web proposcnt des contcnus rmiblirvjjcs, Vous 
pouvc? chobir pbsicurs langues ci dessous ; cKcs scront traitccs 
par ordre de pnorite. 



Francae {France) [It] 



Attuellement, les menus et les boites de 
dialogue sont artiches en Francais (France). 



Q Dans I'onglet General, 
cliquer sur le bouton Langues 



Options Ttilemnt 



beneral | Gecuote | Conhdentiafte | Ccnierw | Connexions | Piocjrarnrriu | Avarice | 
Hage de demanage 

Voue pouves chotat la page a uNiser convne page de demaiiage. 



Adtesse: | about blank 
Fay thrift | P*y M»t | _ 

Pyx* I 



Fieniett Internet tempotaiet 

Le! page; Wet que vous cormtez tont stoc+eet dan* un dottier pou 
Y un a">cnage uteneur plus laptde 



is: 

St^pnmer lee cooftjet ... | Suponmet lee hctaeti. . | 



h'aii.-i.et'e-: 



Le Jussiw Histukjue ujtrtierit krs tern vm lea vajes uue vuus avw 



page; tont eonservees : 



Erfacef IHstotique 



Codcuri-. | Pokes | | Lamjcs I | Acoe»ib»e... | 



Anrafa | 



Avec Mozilla : 

© Aller dans Preferences 



Filp Prtit Vim* On RnnkDifwVfi Tnnls Winrtnw Hulp 

J Undo [ 



Cul 

Copy 

P«t* 



CliliY 

CUH-X 
CuHC 
CUHV 
IM 



Select Ml 


Ctrt+A 


Find in This Page. 


CtrHF 


Find Again 


CtdtC 


FnidPieviuus 


CuHOlufl+O 


Find 1 inks A s Vm i Typ * 




Find Tert As Vou Type 


/ 


fill in form 




Save Form Info 





Q Dans I'onglet Navigateur, sous rubrique Langues, modifier vos langues preferees 



Category 




Helper A portions 
Smart browsing 
Internet Search 
Tabbed Browsing 
Downloads 
0 Composer 
|> Mail& Newsgroups 
l> Vnvacy it Security 
p>ChatZilla 
0 Advanced 
l> Calendar 



Languages 



Languages tor Web f ages 

Web pages arc sometimes available in more than one language. Choose languages for 
displaying wan pagfts, in order nf prAfWnre 
Languages m order of preference: 



French [ft] 

Elighslj/UluLed3l«Li:5 [eii-us] 
Fngjifih [an] 



Character Coding 
Default Character Coding: 
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II faut noter que ce meme principe est retenu pour preciser au serveur les 
types d'encodage acceptes par le navigateur ainsi que les formats reconnus 
(JPEG, GIF, ZIP...). 

On le voit, tout serveur web dispose done des moyens techniques pour deli- 
vrer le contenu disponible le plus adapte. Encore faut-il le faire... 

Selectionner les ressources avec Apache 

Contrairement a ce qu'on pourrait penser le support de cette adaptation 
dynamique est le plus souvent disponible en standard avec Apache, et il est 
selon toute probabilite disponible chez votre hebergeur. Cette fonctionnalite 
est en effet apportee par un module classique de la distribution Apache 
(mocLnegoci ati on). 

Pour beneficier de la negociation disponible dans Apache, nous allons refe- 
rencer cette page avec une URL legerement differente : 
http://www.phpsaloon.com/hello 



CONFIGURATION Verifier la configuration d'Apache 

L'integralite de la configuration d'Apache est le plus souvent contenue dans le fichier 
httpd .conf. 

Dans ce fichier, on pourra verifier que la negociation de contenu est disponible en s'assu- 
rant que le module mod_negoti ati on est bien charge au demarrage d'Apache : 

LoadModul e negoti ati onjiodul e /us r/1 i b/apache/1. 3/mod_negoti ati on . so 

Par ailleurs, I'activation de cette negociation est subordonnee a I'utilisation de I'option 
Mul ti vi ews pour le repertoire des documents (ou tout repertoire parent). Ce point peut se 
verifier en recherchant I'option di rectory correspondant : 

<Di rectory /var/www/> 

Options Indexes Includes FollowSymLinks MultiViews 

All owOver ride None 

Order allow, deny 

Allow from all 
</Di recto ry> 

Enfin, on peut etre amene a controler les correspondances entre les langues (telles que 
designees avec la notation ISO) et les extensions associees, celles-ci sont precisees a I'aide 
de I'instruction Addl anguage : 

Addlanguage fr .fr 
Addlanguage en-us .enus 

► http://httpd.apache.org/docs/ 

Le principe retenu est particulierement simple. II suffit de respecter une convention de nom- 
mage pour les fichiers et de tronquer I'URL demandee avant I'extension. Considerons un 
premier exemple, le traditionnel « Hello world ! ». Par defaut, I'URL de la page serait du 
type: 

► http://www.phpsaloon.com/hello.html 



ALTERNATIVES Les tables 
de correspondances dans Apache 

Apache permet de proceder differemment et de 
maniere plus raffinee en associant a chaque res- 
source une table de correspondances, on parle de 
type-map. 

Cette methode permet de preciser les codages uti- 
lises, la langue et ses variantes mais requiert natu- 
rellement plus d'effort puisqu'il s'agit de creer 
explicitement ces tables de correspondances. 

► http://httpd.apache.org/docs/content- 
negotiation.html 



A partir de la, Apache va rechercher dans le repertoire courant (la racine 
dans notre exemple) les differentes versions de la ressource demandee. Natu- 
rellement cette recherche se fondera sur les preferences linguistiques. 

Encore faut-il avoir defini ces alternatives mais la chose est excessivement 
simple. Pour designer un document HTML en francais on pourra par 
exemple le nommer : 

hello.fr.html 

Une version allemande pourrait quant a elle etre disponible via un fichier 
nomme : 

hello.de.html 

En pratique, Apache va rechercher l'ensemble des ressources dont le nom 
avant toute extension est hello. Fort de cette liste, il appliquera les prefe- 
rences utilisateurs en delivrant le contenu le plus adapte. Ce peut-etre, faute 
de mieux, le fichier par defaut hello.html. 

La correspondance entre le langage (facon ISO, done par exemple en- us) et 
le supplement d'extension (fr, de...) est definie dans la configuration 
Apache. II est tout a fait possible de definir des extensions personnelles pour 
tel ou tel dialecte ou variante d'une langue. 

Ce mecanisme simple peut par exemple s'appliquer a notre squelette XUL 
(le fichier site.xul) et permet ainsi de proposer automatiquement l'interface 
applicative dans la langue du visiteur, ou au pire en anglais. 
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Figure 12-2 PHP Saloon en chinois 
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II faut toutefois rester prudent en matiere de nommage des ressources. En 
effet, Apache prend en compte l'integralite des preferences de l'utilisateur, ce 
qui inclut les preferences en matiere de format et d'encodage. Avec une 
URL demandant la ressource hello, Apache peut ainsi etre amene a choisir 
entre : 

• hello.html 

• hello.fr.html 
mais aussi : 

• hello.gif 

• hello.jpg 

• hello.fr.jpg 

• hello. cgi 

Dans ce cas, ce sont les preferences en matiere de format qui prennent le pas 
sur la langue. Naturellement, ce sont les documents HTML qui heritent de 
la plus grande priorite chez tous les navigateurs, cependant quelques effets 
etranges peuvent apparaitre en ce qui concerne les images ou meme les CGI. 

En cas de doute, il est toujours possible de verifier la realite des preferences 
emises par le navigateur avec phpinfoO. Void par exemple les resultats 
obtenus avec Mozilla 1.6 et Internet Explorer 6 : 

Preferences Mozilla 

Accept : text/xml , appl ication/xml , 
appl i cation/xhtml +xml , 
text/html ;q=0. 9, 
text/plain;q=0.8, 
image/png, image/jpeg, image/gif; 
q=0.2,*/*;q=0.1 

Preferences Internet Explorer 

Accept : image/gif, image/x-xbitmap, 
image/jpeg, image/pjpeg, 

application/vnd.ms-powerpoint, application/vnd.ms-excel , 
appl i cati on/msword , appl i cati on/x-shockwave-f 1 ash , 

On notera que si Internet Explorer est approximatif et se contente d'indi- 
quer les formats binaires supportes, Mozilla pour sa part est beaucoup plus 
pointilleux avec, en particulier, une priorite donnee aux documents XML sur 
les documents HTML... 



PHP et Gettext 



ALTERNATIVE Ouvrir les URL avec fopenO 

Puisque I'ouverture de fichier avec PHP ne nous per- 
met pas de beneficier des mecanismes d'internatio- 
nalisation d'Apache, une solution pourrait etre de 
ne plus acceder a aucun fichier en direct, mais au 
contraire de passer systematiquement par Apache. 
En effet, la fonction f open() disponible dans PHP 
permet d'ouvrir non pas seulement des fichiers 
mais aussi des URL. Cette fonction etant utilisee 
de maniere sous-jacente dans toutes les opera- 
tions sur les fichiers dans PHP (include par 
exemple), cette possibility est disponible partout. 
Voila qui pourrait done resoudre notre probleme ! 
Cela serait sans compter les problemes de perfor- 
mances. Car effectuer une sous-requete HTTP pour 
chaque fichier inclus ou manipule va rapidement se 
transformer en gouffre et plomber les performances. 
En conclusion, il est possible de confier I'integralite 
de I'internationalisation a Apache, mais a un cout 
prohibitif. 



Fonction utilitaire qui reorganise un tableau a ► 
deux dimensions, les lignes deviennent colon- 
nes, les colonnes deviennent lignes. Cette mani- 
pulation un peu fastidieuse est requise car la 
fonction array_muTtisort() ne sait operer 
un tri que dans un sens donne. 



L'en-tete contient les preferences linguistiques. ► 
Nous le decoupons avec explode pour isoler 
chaque preference (elles sont separees par des 
« , »)• 

Pour chaque langue, nous isolons I'eventuel ► 
coefficient de preference. 



Apache permet done deja un premier niveau d'internationalisation. Helas, 
celui-ci se revele plus adapte pour les fichiers statiques que pour les fichiers 
dynamiques. En effet, la methode requiert le clonage puis la traduction des 
fichiers. Or, s'il est naturel de dupliquer le contenu en autant de langues que 
necessaire, il n'en va pas de meme pour le code PHP (ce probleme serait 
identique avec d'autres langages de developpement comme Perl ou Python). 

La modularity en question 

Par ailleurs, ce mecanisme n'est mis en ceuvre que dans la mesure ou Apache 
intervient. Dans une application comme PHP Saloon, que nous avons 
voulue a juste titre modulaire, nombre de fichiers ne sont pas obtenus par 
l'intermediaire dApache mais directement avec des instructions PHP, 
celles-ci ignorent tout du fonctionnement precedent. 

II va done nous falloir, pour ce qui est de PHP, imiter Apache en identifiant 
les preferences de l'utilisateur puis en recherchant la bonne ressource. 

Pour cela, nous allons definir deux fonctions : l'une, T preference (), chargee 
de decoder l'en-tete Accept-Tanguage, l'autre, local ize() chargee de trouver 
la ressource disponible la plus adaptee. 

Contenu du fichier language. php 

<? 

function flip($a) { 
$b = arrayO ; 
foreach($a as $k => $v) 
foreach($v as $k2 => $v2) 
$b[$k2][$k] = $v2; 
return $b; 

} 

function 1 preference() { 

Sprefs = explodeC , ' , $_SERVER[ ' HTTP_ACCEPT_LANCUACE ' ] ) ; 



while (list($k, $v) = each(Sprefs)) { 

$prefs[$k] = explodeC;' , $v) ; 
if (count($prefs[$k]) == 1) 

$prefs[$k][l] = 1; 
else { 

$prefs[$k] [1] = explodeO' , $prefs[$k] [1]) ; 
$prefs[$k] [1] = $prefs[$k][l][l]; 

} 

} 
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$f = flip(Sprefs); 

array_multisort($f [1] ,SORT_NUMERIC, 
return fli p($f) ; 



SORT_DESC, $f[0]); 



Puis tout est trie en fonction du coefficient. 



nction basefile(Sfile) { 
preg_match('/(.+)\. (.*)$/' ,$file,$matches) ; 
return Smatches; 

nction localize($file) { 
static Sprefs = false; 
if (! Sprefs) Sprefs = lpreference() ; 
Sbase = basefile(Sfile) ; 

foreach($prefs as Slangue) { 

Svariant = $base[l] . '.' . $langue[0] . $base[2]; 
if (is_file($variant)) 
return Svariant; 

} 

return $file; 

} 

?> 

Ces deux fonctions peuvent etre testees simplement avec le code suivant : 
<pre><? 

include ( 'language. php') ; 

print_r( 1 preference() ); 

print ( localize ( 'hello.html' ); 

?></pre> 

Pour les besoins du test, on pourra creer differentes versions du fichier 
hello. html utilise dans les illustrations precedentes en placant dans chaque 
fichier le nom de la langue auquel il se refere : 

Contenu du fichier hello.en-us.html 

Hello world americanise ;) ! 

La figure 12-3 presente un resultat obtenu alors qu'un fichier hello.en- 
us.html est disponible en anglais mais pas sa variante francaise. 

Dans PHP Saloon, ces fonctions vont nous permettre de charger les 
modeles de documents XML puis de selectionner les regies de transforma- 
tion en tenant compte des preferences linguistiques. II serait tout a fait pos- 
sible de proceder de meme pour tous les fichiers manipules. Cependant : 

• il faut admettre que cette operation d'aiguillage realisee en PHP et pas 
directement par Apache a un cout ; 

• par ailleurs, une large partie des inclusions de fichiers dans PHP Saloon 
ne vise qua disposer de fonctions PHP liees a la logique metier de 
l'application et totalement independantes de la langue ; 



Fonction utilitaire qui va nous donner le nom du 
fichier prive de son extension. II s'agit d'une ver- 
sion amelioree du couple basename() / 
di rnameQ. 



< Pour chaque langue, il faut verifier si le fichier 
correspondant existe. 
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A File Edit View Go Bookmarks 


Tools Window Hel] 
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Array 
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[0] => Array 




[0] => fr 
[l] -> l 




[ 1] => Array 




[0] => en-us 
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[2] -> Array 




[0] => en 
[1] -> 0.3 




) 

Hello world americanise ! 







Figure 12-3 Selection d'une ressource en 
fonction des preferences linguistiques 
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1 • enfin, comme evoque precedemment, certains fichiers comportent trop 

2 de code PHP pour que leur duplication aux fins de traduction soit accep- 
I. table en termes de maintenance. 

a 
■o 

S2 
92 

s Selection adaptee des elements textuels de 

" ('application avec GNU/Gettext 

Ce dernier point va trouver sa reponse dans l'extension GNU/Gettext de 
PHP. Jusqu'a present notre methode n'a pas varie : des documents dupliques 
pour chaque langue et selectionnes judicieusement le moment venu. 

Avec GNU/Gettext, nous allons au contraire nous interesser a ces fichiers, 
qui principalement faits de code dynamique et non de contenus statiques, ne 
peuvent etre clones. Dans ces fichiers, certaines chaines de caracteres mani- 
pulees seront visibles pour l'utilisateur. Elles doivent done etre traduites. 

GNU/Gettext est l'outil qui va nous permettre de gerer la selection automa- 
tique de la bonne version de chaque chaine en fonction de la langue. Dans 
nos fichiers PHP, une fonction gettextO sera intercalee partout oil une 
chaine doit etre traduite. Considerons a titre d'exemple le code PHP suivant : 

print "Hello world ! "; 



OUTIL GNU/Gettext 

GNU/Gettext est un environnement d'internationalisation complet. 
Le programme xgettext repere et extrait I'ensemble des chames a 
traduire (celles qui font usage de la fonction gettextO). La quasi- 
totalite des langages est supportee, dont PHP. 
xgettext produit un modele d'annuaire dans lequel la version origi- 
nale est precisee mais aucune traduction n'est specifiee. Ce modele 
sera confie a chaque traducteur qui pourra utiliser poEdit pour reali- 
ser une version traduite de I'annuaire. 

Ensuite msgfrnt va optimiser I'annuaire pour que sa consultation 
(qui sera necessaire pour chaque chame a traduire) ne soit pas trop 
penalisante. Le resultat est un annuaire dans un format binaire. 
En general, ces annuaires sont regroupes au meme endroit sur le 
systeme, sous GNU/Linux il s'agit le plus souvent de /usr/share/ 
locale, ce repertoire etant divise en sous-repertoires par langue. 
► http://www.gnu.org/software/gettext/ 
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gettext("Hello world !")■- 



POT 



xgettext 



poEdit 



PO 



msgfrnt 














.MO 









^ *- 



Figure 12-4 Processus d'internationalisation avec Gettext 
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Pour l'internationaliser, nous le modifions comme suit : 
print ( gettext ( "Hello world !" ) ); 

En fonction des preferences linguistiques, la fonction gettextO renverra non 
pas la chaine originale, mais une version internationalisee. 

Pour que la methode soit operationnelle, il faut naturellement construire un 
annuaire de toutes les chaines concernees et proposer des traductions de cet 
annuaire. Pour cela, GNU/Gettext propose un ensemble d'outils. Ces outils 
vont extraire les chaines de caracteres du code source, permettre d'affiner 
l'annuaire, puis de le traduire et enfin de le stocker de maniere optimale. En 
production chaque invocation de la fonction gettextO aboutira en une con- 
sultation de l'annuaire. 

Le mecanisme general est done relativement simple, par ailleurs la selection 
de la langue preferee repose sur un autre outil standard du monde Unix/ 
Linux : les « locales ». 

La notion de « locale » tente de factoriser en un seul outil l'ensemble des 
parametres linguistiques. La langue naturellement, mais aussi le formatage 
du temps, des dates et des nombres. L'ensemble de ses parametres est modi- 
fiable avec la fonction setlocaleQ disponible dans PHP. 



OUTIL poEdit 

Les annuaires utilises par GNU/Gettext sont tous 
des fichiers texte (seules les versions figees pour 
distribution sont transformers pour ameliorer 
les performances). Dans I'absolu toutes les ope- 
rations de traduction peuvent done etre reali- 
sees manuellement avec un simple editeur de 
textes. 

Toutefois des outils existent pour rendre I'opera- 
tion plus simple et moins longue. C'est le cas de 
poEdit, la reference en la matiere, qui dispose 
egalement d'une fonction de traduction auto- 
matique capitalisant sur les traductions deja 
realisees (on sait qu'en effet un nombre assez 
important de mots et d'expressions reviennent 
d'un logiciel a I'autre). Une option qui ne dis- 
pense pas de tout travail, mais qui peut simpli- 
fier reellement I'intemationalisation. 
PoEdit est disponible sous Windows et tous les 
Unix. 

► http://poedit.sourceforge.net/ 

Figure 12-5 Interface principale de poEdit sous Windows 
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ALTERNATIVE Forcer une langue donnee 

Dans ce chapitre nous avons evoque la situation la 
plus delicate qui consiste a proposer d'emblee le 
contenu le plus adapte aux attentes du visiteur. 
Toutefois le plus souvent, cette approche doit etre 
completee en proposant de choisir explicitement la 
langue d'affichage et ceci independamment des 
preferences de navigation. 
Dans ce cas, on pourra placer des liens pour cha- 
que langue (en general des images de drapeaux) 
et forcer les locales en positionnant par exemple 
un cookie (ce qui necessitera de revoir un peu nos 
fonctions). 

II convient par ailleurs de ne pas negliger les ele- 
ments directement pris en charge par Apache en 
referencant dans les pages de chaque langue les 
fichiers localises et non les versions generiques 
(i ndex . en . html et non index par exemple). 



Cette fonction requiert deux parametres, le premier precise la nature de l'ele- 
ment qui sera modifie (par exemple le formatage des nombres), et le second, 
la langue retenue. 

Pour obtenir une version francaise des chaines de caracteres, on pourra done 
ecrire : 

setlocale ( LC_ALL , 'fr_FR.iso-8859-15' ); 

Ou de maniere moins precise : 
setlocale ( LC_ALL , 'fr' ); 

Dans ce cas, ni la variante linguistique (on pourrait par exemple souhaiter 
f r_CA pour le Quebec), ni l'encodage attendu ne sont precises. 

Pour conserver les messages par defaut, tout en retrouvant un formatage de 
la date francisee (avec par exemple les jours avant le mois et non l'inverse 
comme e'est le cas dans le monde anglophone) on pourra utiliser : 

setlocale ( LC_TIME , 'f r_FR.iso-8859-15 ); 

Ce systeme est mis en ceuvre a tous les niveaux des systemes Unix et vaut 
done pour les messages d'erreur du systeme et des outils utilises, PHP 
n'etant que l'un de ces environnements de plus a mettre en ceuvre. 

Dans PHP Saloon, il faudra done identifier dans nos differents controleurs, 
les eventuelles chaines a traduire et produire le catalogue de traduction ad 
hoc. Par chance, ces chaines ne sont pas nombreuses, ce qui est la conse- 
quence directe de nos choix architecturaux. Avec MVC, nous avons claire- 
ment segmente l'application. 

II demeure que dans PHP Saloon comme pour la quasi-totalite des applica- 
tions plusieurs mecanismes d'internationalisation vont cohabiter, chacun 
disposant de son mecanisme propre pour determiner les preferences utilisa- 
teurs. Ce constat implique de porter une attention particuliere a la coherence 
entre les langues choisies : 

• par Apache ; 

• par nos fonctions PHP ; 

• et selectionnees avec set"locale(). 

A defaut, nos visiteurs pourraient bien experimenter un joyeux melange. Ce 
point est notamment particulierement sensible lorsque des variantes linguis- 
tiques entrent en jeu. Par exemple, pt_BR pour le Bresil ou encore zh_TW et 
zh_CN pour Taiwan et la Chine. 
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En resume... 

L'internationalisation d'une application web n'est pas chose facile. Cepen- 
dant, sauf a vouloir se cantonner a un profil de visiteurs locaux, l'adaptation 
pour les principales langues du monde et le support de l'anglais notamment 
sont indispensables. Cela vaut pour les sites commerciaux comme pour les 
autres, on peut penser par exemple aux sites communautaires tres en vogue. 

Ainsi que nous venons de l'experimenter, PHP peut a la fois tirer profit des 
outils mis a disposition par le serveur web utilise et mettre en oeuvre une 
localisation plus fine du contenu. 

Cette internationalisation ne fait que mettre en exergue l'importance de nos 
choix precedents en matiere d'organisation du code, de separation des diffe- 
rents roles comme le preconise l'architecture MVC. Qu'aurait-il ete possible 
de faire si, comme c'est le cas dans nombre d' applications PHP disponibles 
sur le Web, tous les elements (presentation, contenu et donnees metier) 
avaient ete melanges dans un meme document ? 



E 
2 
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chapitre 




Navigateur 




Script PHP 



ob_start(); 


\ 


<html> 




<head> 


\ 


<title>Test</title> 


</head> 




<body> 




<? 




print "Hello world!"; 


?> 




</body> 




</html> 




print 


\ 


ob_get_contents() 



Optimisations et 
fonctions avancees 



Internationalisation, adaptation dynamique au 
navigateur client, PHP Saloon a desormais 
tout pour plaire. 

Restent toutefois des optimisations fort utiles a 
mettre en ceuvre pour ameliorer au quotidien 
l'exploitation du code et le simplifier, avec a la cle 
une meilleure qualite. 



SOMMAIRE 

► Factorisation du code 
redondant 

► Traitement des documents 
produits 

► Utilisation des streams 

► Suppression d'Apache 

MOTS-CLES 

► auto_preprend_file 

► stream_socket_server 
output buffering 



CONFIGURATION Modification des parametres 
PHP dans Apache et par repertoire 

La modification des options de configuration de 
PHP au sein du fichier php.ini n'est pas toujours 
realisable. C'est notamment le cas chez la plupart 
des hebergeurs fournisseurs de solutions mutuali- 
sees. 

Toutefois, il est aussi possible de fixer certaines 
options en utilisant I'instruction php_val ue dis- 
ponible dans Apache des lors que PHP est confi- 
gure en tant que module. Ce qui est le plus sou- 
vent le cas. 

Dans cette situation, I'instruction php_va~lue 
peut etre utilisee dans le fichier de configuration 
principal d'Apache (mais celui-ci est rarement plus 
accessible que php.ini) et surtout dans les 
fichiers .htaccess qui peuvent etre crees pour un 
repertoire donne : 

php_va~lue auto_prepend_file 
/var/www/header. php 



Mutualisation du code commun avec les 
inclusions automatiques 

Dans une application comme PHP Saloon le code developpe ne peut rester 
monolithique. L'application est decoupee en modules, en fichiers, ce qui est 
d'ailleurs essentiel si Ton souhaite isoler les differents composants mis en 
oeuvre. 

II en resulte l'inclusion reguliere de modules standards en debut de fichier. 
Ainsi, si Ton observe le code PHP ecrit pour gerer l'envoi de messages et les 
fils de discussion, on ne trouve pas moins de six fichiers inclus : 

<? 

requi re_once 'inc/vue.php' ; 

requi re_once 'inc/i/icontroleur.php' ; 

requi re_once 'inc/controleurbase.php' ; 

requi re_once 'inc/utils.php' ; 

requi re_once 'inc/sessionvalide.php' ; 

requi re_once ' inc/connecte.php' ; 

La plupart de ces elements vont etre constamment inclus, quel que soit le 
module en cours. C'est le cas des interfaces implantees par nos composants, 
mais aussi des fonctions utilitaires ou encore de la gestion des sessions. 

Naturellement, il est possible de regrouper l'ensemble de ses dependances 
dans un seul et meme fichier que nous appelons le prerequis.php. Celui-ci 
importera l'ensemble des elements generalement necessaires et nous pou- 
vons alors simplifier le code de nos fichiers PHP en remplacant les multiples 
instructions include par une seule operation : 

requi re_once 'prerequis.php'; 

Mais PHP propose une solution encore plus elegante. Grace a la variable de 
configuration auto_preprend_file, il est possible de faire en sorte que notre 
fichier de prerequis soit automatiquement inclus en tete de tous les fichiers 
PHP. Cette variable est disponible dans le fichier php.ini : 

auto_prepend_file = "/var/www/inc/pre requi s. php" 

Avec cette technique nous sommes surs que des la premiere ligne de nos 
fichiers PHP, l'environnement logiciel minimal sera disponible. 
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Le plus souvent on couplera l'utilisation d'auto_prepend_file a une adapta- 
tion de la variable include_path de maniere a ne specifier aucun chemin 
absolu pour acceder aux fichiers manipules. 

include_path = ". ;/usr/share/phpsaloon/include;/var/www/inc" 
auto_prepend_file = "prerequis.php" 

Comme on est en droit de l'attendre, un equivalent de auto_prepend_file est 
disponible pour ajouter des elements a la fin des fichiers PHP. Dans ce cas la 
variable de configuration est auto_append_file. 

Pour PHP Saloon, nous pouvons en faire un usage tout a fait judicieux en 
placant le traitement de la vue dans ce fichier automatiquement inclus. En 
effet, par definition la vue intervient a la fin de chaque fichier PHP et de 
maniere systematique. Plutot que de dupliquer ce code il est possible de 
I'adapter pour le rendre generique et enfin le placer dans un fichier qui sera 
inclus pour nous. 

Le code concerne est relativement simple : 

$vue = new vue() ; 

if (contenu_prefere() == 'xul') 

header('Content-type: text/xml ') ; 
print $vue->transform($controleur, ' echanges .xsl ') ; 



Cependant, il n'est pas generique. En effet, chaque portion de code differe Fjgure 1M Agr - gation automatique d ., 
en operant sur une feuille XSLT differente. On peut ainsi constater que, en-tete et d'un pied de page dans PHP 

selon toute logique, le code precedent effectue le rendu des echanges de 
messages. 

Pour contourner ce probleme, nous allons imposer une convention : desor- 
mais les noms des fichiers PHP et de leur transformation XSLT associee 
sont identiques. Par exemple, la transformation XSLT du fichier 
echanges. php est disponible dans le fichier echanges. xsl. 

Cette regie de programmation toute simple va nous permettre d'adapter 
legerement le code initial de maniere a le rendre generique : 

$vue = new vue() I 

if (contenu_prefere() == 'xul') 

header('Content-type: text/xml ') ; 

print $vue->transform($controleur , 
basename($_SERVER['PHP_SELF'] , ' .php') . '.xsl'); 

Nous utilisons pour cela la variable $_SERVER['PHP_SELF'] qui contient le 
nom du script PHP courant. Cette nouvelle version du code peut etre isolee 
dans un fichier rendu. php et auto-inclus en configuration PHP comme suit : 

auto_append_fi le = "rendu. php" 



header 



■Php 



footer 



Avec ces deux directives nous avons simplifie sensiblement le noyau appli- 
catif de PHP Saloon. II faut toutefois rester precautionneux avec ces meca- 
niques d'inclusion. 

• Premierement, inclure a tout va risque d'etre penalisant en termes de 
performance : car utilise ou pas, le code PHP doit etre analyse et compile 
a la volee, ce qui engendre des operations parfois plus couteuses que 
1' execution elle-meme. 

• Deuxiemement, le code ainsi inclus doit faire l'objet d'une attention 
toute particuliere, car si une simple erreur s'y produit, l'integralite des 
pages du site seront rendues inaccessibles (toutes victimes de la meme 
erreur). 

Controle et traitement a posteriori des 
documents produits 

Navigateur Apache Script PHP 







► 

Demande d'une page 


-< 


<html> K 
<head> \ 
<title>Test</title> 
</head> 
<body> 
<? 

print "Hello world!"; 
?> 

</body> 
</html> 


Retour des informations 


M— 







Figure 13-2 Flot des donnees en mode normal 



L'inclusion automatique d'en-tetes et de pieds de page apporte une simplifi- 
cation en termes d'organisation du code, mais ne procure aucun gain en 
termes de controle sur la production du resultat. En effet, des qu'un element 
est produit : soit parce qu'il s'agit directement de contenus statiques non 
PHP, soit via les instructions pri nt ou echo par exemple, l'interpreteur PHP 
perd le controle sur l'information. Celle-ci est transferee dans les mains 
d'Apache qui, le plus souvent, va la transmettre sans attendre au navigateur 
du visiteur. Ce fonctionnement explique d'ailleurs pourquoi la modification 
des en-tetes HTTP avec l'instruction header() ne peut plus fonctionner si 
des elements ont deja ete produits pour l'utilisateur. 



PHP propose toutefois de controler ce flot en modifiant le parcours. II est 
ainsi possible de stocker le contenu destine au navigateur avant de le diffuser, 
par exemple pour lui faire subir un traitement. 



Navigateur 



Apache 



Script PHP 




ob_start(); 



<html> 
<head> 

<title>Test</title> 
</head> 
<body> 
<? 

print "Hello world!" 
?> 

</body> 
</html> 



print 

ob_get_contents() 




Figure 13-3 Flot des donnees avec mise en tampon 



Pourquoi proceder de la sorte dans PHP Saloon ? 

1 Pour gagner en performance et diffuser un contenu compresse, done plus 
rapide a transporter sur Internet. Le navigateur, disposant du contenu 
plus rapidement pourra afficher la page dans un delai bien plus court. 
D'ou un meilleur confort pour l'utilisateur. 

2 Pour simplifier la creation de documents qui seront ensuite repris dans 
leur ensemble pour une transformation globale, a la maniere d'un 
modele. 



Compression des pages a la volee 

Pour envoyer nos pages compressees, nous allons utiliser les fonctions de 
mise en tampon evoquees precedemment. Dans l'en-tete, nous utiliserons 
ob_start() qui marquera le debut du stockage. II convient naturellement 
dans notre cas de s'assurer que rien n'a deja ete envoye au navigateur. Dans le 
pied de page, la fonction ob_get_contents() permettra d'obtenir tout le con- 
tenu produit. II faut alors le compresser, puis adapter les en-tetes pour indi- 
quer qu'une compression a ete effectuee. 



ALTERNATIVES mod_gzi p 
pour doper les performances 

PHP dispose en propre de tous les mecanismes 
necessaires a la compression des pages. Toutefois, 
et en particulier dans le cadre de sites mixtes, 
constitues a la fois de pages statiques et de pages 
dynamiques, il peut etre judicieux de laisser la 
compression des echanges a Apache. 
Dans ce cas c'est I'integralite des contenus textes, 
statiques ou non, qui seront compresses. Apache 
dispose pour cela d'un module ad hoc, il s'agit de 
mod_gzip. Celui-ci ne fait pas partie integrante 
de la distribution Apache mais le projet est tele- 
chargeable depuis SourceForge. 
► http://sourceforge.net/projects/mod-gzip/ 



PHP nous permet de reduire davantage ce processus tres simple, puisque la 
fonction ob_gzhandler() effectue tout simplement toutes les operations du 
pied de page. Celle-ci peut etre directement passee en parametre a 
ob_start() et sera alors appelee par PHP a la fin du script. 

Finalement, il suffit done de legerement modifier notre fichier d'en-tete en 
ajoutant simplement : 

ob_start("ob_gzhandler") ; 

Nous sommes la dans l'usage le plus elementaire des fonctions de mise en 
tampon qui peuvent etre utilisees notamment pour reprendre du code exis- 
tant en ajoutant des elements ou en modifiant le contenu produit sans tou- 
cher au code original. 

Decouplage complet entre logique metier et vue 

Ces fonctions peuvent aussi etre utilisees pour pousser encore plus loin le 
decouplage entre le controleur et la vue. Ainsi, dans PHP Saloon, il nous est 
impossible d'ignorer l'existence des traitements qui seront realises par la vue. 
D'ailleurs, il appartient au controleur de produire non pas simplement un 
document XML mais de le produire dans un format et selon une interface 
donnee (en l'occurrence sous la forme d'un objet DOM). 

Modele utilise pour I'identification 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<phpsal oon> 
<formulai re> 
<connecte> 

<pseudo name="form[pseudo] " question="Nom de code" 
type="string"> 
<! [CDATA[foo]]> 
</pseudo> 

<motdepasse name="form[motdepasse] " question="Mot de passe" 
type="secretstring"> 
<! [CDATA[bar]]> 
</motdepasse> 
</connecte> 
</formulai re> 
<info type="message"> 

Pas inscrit(e)? <a href="inscription.php">C~liquez-ici</a>! 
</i nf o> 
</phpsa~loon> 

En utilisant les fonctions de mise en tampon nous pourrions laisser le con- 
troleur produire son document XML comme il le souhaite. Au terme du 
script PHP, le contenu produit serait alors recupere dans le tampon et traite 
pour etre rendu. 
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'3 

c 

5 
« 

Un exemple possible consiste a revoir le cas du formulaire de connexion a | 
PHP Saloon. Nous avons choisi d'ouvrir un modele en XML, de l'analyser, ^ 
puis de modifier l'arbre XML resultant. En realite nous pourrions proceder ^ 
tout autrement en nous contentant de produire un document XML texte | 
sans meme analyser quoi que ce soit. Charge a la vue de terminer le travail R 
comme bon lui semble. 



Creation d'un document XML texte de facon simplified 

<?xml version="1.0" encoding="iso-8859-l" ?> 
<phpsaloon> 
<formulai re> 
<connecte> 

<pseudo name="form[pseudo] " question="Nom de code" 
type="stri ng"> 

<? 

// code PHP ad hoc (determinera le nom du pseudo a placer ici 

?> 

</pseudo> 

<motdepasse name="form[motdepasse] " question="Mot de passe" 
type="secretstri ng"> 



// idem pour le mot de passe 



> 



</motdepasse> 
</connecte> 
</formulai re> 
<info type="message"> 

<? 

// eventuel message d'erreur 

?> 

</info> 
</phpsal oon> 

Cette methode permet de tirer profit de modeles statiques dans lesquels un 
code PHP minimaliste insere les elements dynamiques. Ce document est 
produit en ignorant tout de ce qui sera opere comme traitement par la suite. 

Pour aboutir au resultat escompte, il suffirait alors de modifier le pied de 
page propose au debut de ce chapitre en ajoutant une phase d'analyse du 
tampon. 

Pied de page modifie 

Scontroleur = new DOMDocumentO ; 
$controleur->loadXML(ob_get_contents()) ; 
$vue = new vue() ; 
if (contenu_prefere() == 'xul') 

header('Content-type: text/xml ') ; 
print $vue->transform($controleur , 
basename($_SERVER['PHP_SELF'] ,' .php') . '.xsl'); 



o 

i 
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Dans le cas de PHP Saloon, le gain n'est pas forcement evident dans la 
mesure ou nous avions deja adopte une architecture (MVC) tres modulaire 
et que la phase d'analyse XML est, quoi qu'il arrive, indispensable. 

Malgre tout, on observe que dans le cadre d'un decoupage des responsabi- 
lites, notamment entre equipes de developpement, cette methode permet 
d'obtenir encore plus de latitude. En effet, cote controleur, la production du 
document XML de reference n'est pas tributaire d'un modele de donnees 
impose (en l'occurrence DOM) et de la meme facon, cote vue, la disparition 
de cette contrainte permettra d'adapter l'implantation en fonction de l'expe- 
rience et des evolutions d'usage. On pourrait par exemple imaginer utiliser 
un processeur XSLT DOM dans une premiere phase, puis adopter un outil 
different par la suite, voire laisser les transformations a la charge d'un filtre 
Apache, cela en toute transparence pour la partie controleur. 



CONFIGURATION Activer le support 
des streams etendus 



Pour que les differents protocoles reseau soient 
disponibles avec I'ensemble des fonctions PHP 
comme fopen(), il peut etre necessaire de modi- 
fier la valeur de la variable all ow_ur~l_f open 
dans le fichier php.ini. Pour que le support soit 
actif, la variable doit avoir la valeur TRUE. 
Le support de ces streams peut aussi etre desac- 
tive a la compilation. 



Optimisation de la modularity avec les flots 
personnalises 

Comme on le voit, PHP propose des mecanismes sophistiques pour mani- 
puler les flots de donnees qui sont produits au cours de l'execution des 
scripts. PHP 5 etend encore ces fonctionnalites en proposant tout un even- 
tail de nouvelles possibilites pour manipuler l'information avec encore plus 
de facilite. 

Ainsi, nous avons pu constater avec l'internationalisation de PHP Saloon 
que l'acces selectif aux fichiers de telle ou telle langue n'etait pas sans diffi- 
culte. II nous a fallu definir notre propre fonction de selection a intercaler 
partout entre le document a manipuler et les fonctions d'inclusion d'ouver- 
ture. Par exemple pour charger un modele XML : 

include (localize ('identification.xml ')) ; 

Dans le cas present ce n'est pas dramatique, mais il peut rapidement en etre 
autrement, notamment au sein des regies de transformation avec des ins- 
tructions xsl : i ncl ude qui vont passer au travers des mailles de notre interna- 
tionalisation. 

Par chance, PHP va nous permettre de creer notre propre protocole pour 
manipuler les fichiers (des flots de donnees comme les autres). II existe natu- 
rellement un certain nombre de protocoles standards, meme si dans PHP 
Saloon nous n'en n'avons pas necessairement eu l'utilite. Vbici quelques 
exemples : 
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include 'foo.php' ; 
include 'file://foo.php' ; 

include 'http://www.stephanemariel .com/foo.php' ; 
include 'http://ftp.stephanemariel .com/pub/foo.php' ; 
include ' compress . zl i b : //f oo . php . gz 

Dans ces exemples, le protocole compress. zlib permet d'acceder a des 
fichiers compresses directement. La fonction stream_get_wrappers() permet 
d'obtenir la liste des protocoles disponibles. 

Exemple de protocoles disponibles avec PHP 5 en ligne de commande 

vl:/var/www/v2# php -r ' pri nt_r(stream_get_wrappers()) ; 1 

Array 

( 

[0] => php 
[1] => file 
[2] => http 
[3] => ftp 

[4] => compress .zli b 

) 

Tous ces protocoles sont disponibles et applicables partout oil des fichiers et 
des fiots sont manipules, avec include, require, fopen. Enfin, la bibliotheque 
XML utilisee par PHP pour manipuler et creer les documents DOM est 
compatible avec ces possibilites, au niveau des interfaces PHP, comme dans 
l'exemple suivant : 

<?php 

$dom = new domdocumentO ; 

$dom->l oad ("compress . zl i b : //xml /i denti f i cati on . xml . gz") ; 

?> 

Mais aussi au niveau des instructions XSLT. On pourrait done imaginer, 
dans PHP Saloon, de charger directement les modules XSLT compresses : 

<xsl:include href="compress.zlib://page/standard.xsl" /> 

On notera par ailleurs que e'est le protocole f i 1 e qui est utilise par defaut 
pour acceder a un fichier local, les deux exemples suivants sont done identi- 
ques : 

include 'foo.php' ; 

i ncl ude ' f i 1 e : //f oo . php ' ; 

Pour PHP Saloon, nous pourrions done simplifier la localisation en definis- 
sant une version remaniee du protocole file, par exemple nomme lfile 
(pour localized files). Ce protocole prendrait automatiquement en charge la 
selection des fichiers demandes en fonction des preferences linguistiques. 
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A RETENIR Au-dela des protocoles, les filtres 

Les possibilites de PHP en matiere de flot ne se 
limitent pas aux protocoles. II est possible de defi- 
nir des filtres. Les filtres ne s'occupent pas du 
transport, comme le font les protocoles mais trans- 
forment les donnees a la volee. 
La liste des filtres disponibles est accessible grace 
a la fonction stream_get_filters() et de 
nouveaux filtres peuvent etre definis d'une 
maniere analogue aux flots, mais en utilisant la 
fonction st ream_f i 1 te r_reg i s te r () . 
Pour chaque flot manipule, par exemple avec 
fopen, lesfonctions stream_append_fi lter() 
ou stream_prepend_filter() permettront de 
modifier la suite de filtres appliques. 
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I Nous pourrions alors ecrire : 



include ' lfile://xmVidentification.xml ' ; 



| Et dans les fichiers XSL 

3 



<xs~l : include href="lfile://page/standard.xs~l" /> 

Dans les deux cas, le fichier ouvert serait celui correspondant aux preferences 
indiquees par le navigateur. 

Mais peut-etre la definition d'un nouveau protocole n'est-elle pas aussi 
simple qu'il y parait ? Bien au contraire, il suffit de definir une classe avec 
quelques methodes cles (assez naturelles au demeurant) et d'utiliser la fonc- 
tion stream_wrapper_register(). 



Fonction 


Role 


stream_open 


Appelee lors de I'ouverture du flot. 


stream_close 


Appelee lors de la fermeture du flot. 


stream_read 


En charge de la lecture des donnees. 


stream_write 


En charge de I'ecriture. 


stream_eof 


Indique si la fin du flot est atteinte. 


stream_tel 1 


Retourne la position dans le flot de donnees. 


stream_seek 


Positionne le pointeur a un endroit precis dans le flot de donnees. 



Ces methodes constituent le minimum vital, mais des methodes comple- 
mentaires peuvent etre requises notamment lorsque la notion de repertoire 
est indispensable. 

On le voit, le potentiel offert par PHP 5 est considerable, on pourrait par 
exemple songer a definir des protocoles permettant un couplage transparent 
vers les bases de donnees. 



Suppression d'Apache 

Avec les streams, PHP 5 permet la manipulation sans limite des flots de 
donnees associes notamment aux fichiers. Mais cette notion de flot s'etend 
assez naturellement aux donnees reseau et aux connexions. PHP 5 va done 
proposer, sur ce terrain aussi, de nombreuses ameliorations et notamment 
deux nouvelles instructions cles : 

• stream_socket_cl ient() 

• stream_socket_server() 
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Cette deuxieme instruction permet ni plus ni moins de transformer votre 
PHP en un serveur, par exemple pour delivrer du XML, et de repondre a 
une requete SOAR Aucune limite en la matiere puisque PHP vous laisse 
definir votre protocole et l'agencement des echanges. Dans la plupart des 
cas, on souhaitera se caler sur HTTP, quitte a n'implanter qu'une sous- 
partie. 

L'exemple suivant permet de se faire une idee de la methode a suivre pour 
creer un serveur et illustre la simplicity avec laquelle cela est possible : 

<? 

Secoute = stream_socket_server('tcp://0. 0.0. 0:42/' , Serrno, 

Serrstr) ; 



if (Secoute) 

while (Sconnexion = stream_socket_accept($ecoute)) { 



fwrite (Sconnexion, "<!-- Hello this is the PHP Super 

Server. \n")l 
fwrite (Sconnexion, "May I help you ? -->\n"); 
$xml = " ; 

while ((Sligne = fgets($connexion)) && strcmp(trim($ligne) , 
"•")) 
$xml .= Sligne; 

$dom = new domDocument() ; 
$dom->loadXML($xml) ; 
$xsl = new domDocumentO ; 

$xsl->load('test.xsT) ; 
Sxslproc = new xsltprocessor() ; 
$xsl proc->importStylesheet($xsl) ; 

fwrite (Sconnexion , $xsl proc->transformToXML($dom)) ; 
fclose($connexion) ; 

print "Hourra! Et un client de servi!\n"; 

} 

print Serrstr; 
?> 

Naturellement dans la realite on ne se contenterait pas d'une petite transfor- 
mation XSLT, mais notre serveur pourrait jouer les intermediaires entre 
deux applications metier et se muer en traducteur entre le XML d'un pre- 
mier logiciel et celui du second. 



< Ecoutons sur un port donne (le Web serait 80 
mais nous avons choisi un port exotique) en uti- 
lisant le protocole TCP. 0.0.0.0 permet d'ecouter 
sur toutes les cartes reseaux disponibles. Au 
besoin, il est possible de preciser I'adresse IP 
d'une seule carte. 



< Nous allons traiter en boucle tous les clients qui 
se presentent. Des que c'est le cas, une con- 
nexion est construite pour nous a partir de la 
socket d'ecoute. 

< Nous commengons par une petit message de 
bienvenue... 



< Puis nous allons lire tout ce qui nous est envoye 
par le client. 



i En esperant qu'il s'agisse de XML. 



< Nous allons transformer tout ga. 



< Et renvoyer le resultat a notre client. 

i n_e travail est termine, nous fermons la con- 
nexion. II reste a attendre le prochain client. 



231 



Ceux qui douteraient encore de la realite de cet exemple pourront consulter 
les copies d'ecran du test de ce serveur en ligne de commande. 



Figure 13-4 

Lancement du serveur 
sur une machine 



HI 



m TiV Vh<> CrrtrrJ Wtofciw lh+ 



v\ :/v.ir/www/v2# php -f sprvor . php 



-] ]»l 
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Figure 13-5 

Connexion au serveur 
depuis une autre machine 



HHE 



rfc r* *Wm Contra! Wrttrm Ifc^ 



Bf;rv«;r:-f telnet. 10. 128. 0.251 42 

Trying 10.128.0.251 .. . 

Connected to 10.128.0.251. 

Escape character is '"]'. 

<! — Hello this is the PHP Super Server. 

1.iy T ht'lp you 1 — > 



Figure 13-6 

Envoi d'une requete XML 



HI 



sorvi'r:-! telnet. 10.128.0.251 42 
Trying 10.128.0.251... 
Connected to 10.128.0.251. 
Escape character is "•}'. 

— Hello l.his is t.he PHP Super Server. 
May I help you ? --> 
</xml version-" 1.0" v> 
<:hello>Test Test!</hello> 



Figure 13-7 

Reponse du serveur 



server:-* l.elnet. 10.128.0.251 42 

Trying 10 . 128 . 0 . 251 . . . 

Connected to 10.128.0.251. 

Escape character is **)'. 

•:! — Hello this is the PHP Super Server. 

1<»y T help yon ? --> 

<?xml ver3ion="1.0" ?> 

<hellovrest Test!</hello> 

<tiLml> 

<head> 

<meta http equiv="Content Type" content="text/html; charset=UTF 8" 

<title>Hello!</title> 

</head> 

<tx>dy>Test. Tost.!</body> 
</html> 

connection closed by foreign host, 
server:-* I 



- 
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Naturellement, PHP nous permet avec stream_socket_client() d'exploiter 
notre serveur de maniere moins primitive, comme le montre cet exemple et 
le resultat obtenu. 

<? 

Sconnexion = stream_socket_client('tcp://10. 128.0. 251:42/' , Serrno, 
Serrstr) ; 
if (Sconnexion) { 
fgets(Sconnexion) ; 
fgets(Sconnexion) ; 

fputs($connexion, "<?xml version=\"l-0\" ?> 
<heno>Hello tous!</heTTo>\n.\n") ; 
while(! feof (Sconnexion) ) 
print fgets(Sconnexion) ; 

} 

?> 



ALTERNATIVES NanoWeb 



Faire un serveur complet a la main n'est pas force- 
ment de tout repos. Pour ceux qui souhaiteraient 
se passer reellement a" Apache tout en beneficiant 
d'un serveur entitlement concu autour de PHP, il 
existe NanoWeb qui repond totalement a cet 
objectif tout en conservant des performances 
acceptables. 
► http://nanoweb.si.kz/ 



1 3 Hello! - Microsoft Internet Explorer 




inl 




Fichier Edition Affichage Favoris Outils ? 




| ^Precedente » <Q J| t^fMedia # 


Adresse |^) http://10.128.0.25:_3j 








J 


Hello tous! 














J 


.g] Termine 


•£ Internet 







Figure 13-8 Appel du serveur depuis un script PHP 
et affichage du resultat dans un navigateur 



Pour faciliter l'ecriture de clients, PHP integre par ailleurs l'extension 
CURL. Les fonctions de cette extension evitent d' avoir a reinterpreter soi- 
meme les protocoles les plus courants (comme HTTP, FTP...) et simplifient 
sensiblement l'interaction avec des services distants. 



233 



En resume 



Organisation du code, controle fin des flots de sortie, possibilite de fonc- 
tionnement autonome, PHP 5 accroit encore les capacites de PHP. Autant 
d'aptitudes qui repondent de mieux en mieux aux exigences actuelles : tout 
d'abord en termes fonctionnels, puis avec une adequation reelle entre PHP 5 
et l'univers des services web, des echanges XML, en termes de qualite et de 
securite, et enfin avec des options raffinees pour maitriser le perimetre appli- 
catif au plus juste. De quoi s'interroger legitimement sur l'opportunite de 
recourir a des solutions plus lourdes et indubitablement plus couteuses, y 
compris pour les gros projets. 



Votre serveur PHP 
a domicile 



Configuration PHP en local 



Avec la democratisation des acces haut debit, cable ou ADSL, on peut etre 
tente d'heberger directement son application web a domicile, sur son ordina- 
teur personnel. Si cette solution vous tente, voici quelques elements cles 
avant de demarrer. 



II est bien sur possible de tester PHP chez soit, sans 
se preoccuper d'lnternet. Dans ce cas, rendez-vous 
directement a la section 2. 



Avantages et inconvenients 



Avant toute chose il est important de bien peser le pour et le contre d'un 
hebergement a domicile. Transformer son salon en salle machine n'est evi- 
demment pas sans consequence. 

Cette boutade met en avant un premier point, souvent neglige. Un serveur 
web, avec ou sans PHP, doit rester operationnel 24 heures sur 24. Cela 
implique que l'ordinateur qui sera utilise pour heberger l'application devra 
rester allume en permanence. 

Cet etat de fait a comme premiere consequence notable une consommation 
electrique non negligeable. Songez que le seul processeur peut consommer 
jusqu'a 100 W ! De plus le corollaire de cette forte consommation est la cha- 
leur et par voie de consequence l'importante necessite de refroidissement de 
l'ordinateur. Quiconque s'est approche d'un micro-ordinateur aura pu cons- 
tater que le bruit est une reelle nuisance. Naturellement, il est possible 
d'ameliorer les choses, mais dans la plupart des cas il faudra apprendre a 
vivre avec ce doux ronronnement. 



Si ces nuisances ne constituent pas vraiment un point en faveur de cette 
solution, elles mettent en avant l'un de ses avantages cles : le serveur est a 
portee de main pour realiser toutes les operations de mise a jour et de modi- 
fication. Cette proximite facilite enormement le travail tout en procurant 
une impression de controle et de securite certaine. 

Cette latitude en termes de maintenance se retrouve evidemment au niveau 
de la configuration logicielle. II devient possible de construire des environ- 
nements logiciels bien plus complexes ou moins « tendances » que ceux dis- 
ponibles en standard chez les hebergeurs de services mutualises. 

Compte tenu de la jeunesse de PHP 5, l'utilisation d'un ordinateur per- 
sonnel peut notamment permettre de disposer d'un hebergement sans 
attendre la migration necessairement progressive des hebergeurs. 

On le voit, la liberte est totale, mais comme souvent, elle s'accompagne 
d'une responsabilite elargie, notamment en termes de securite. II vous 
appartiendra d' assurer les mises a jour, la securisation quotidienne de votre 
serveur, en appliquant les patchs de securite par exemple. Ce travail quoti- 
dien peut etre rapidement fastidieux, d'autant qu'il ne constitue pas l'objectif 
premier de l'installation. 

Enfin, dernier point, a ce jour les liaisons ADSL et cable sont asymetriques, 
c'est-a-dire que (dans le cas des solutions grand public) le debit en reception 
est sensiblement plus important que le debit en emission. Ce detail tech- 
nique n'a que peu d'importance pour un usage classique. En effet, nous tele- 
chargeons tous bien plus de donnees que nous n'en emettons. 

Cependant, les possibilites s'inversent quand on se place du point de vue du 
visiteur d'un site heberge a domicile. En effet, celui-ci est limite par la capa- 
cite demission, le plus souvent de 256 Kbit/s, alors qu'en telechargement la 
capacite depasse souvent 2 Mbit/s, soit 10 fois plus ! 

Si la mise a disposition de fichiers etait dans vos intentions, sachez que cela 
risque d'etre tres laborieux, pour vos utilisateurs mais aussi pour vous, car le 
moindre telechargement saturera votre capacite d'emission, et meme les 
quelques elements emis pour obtenir une page web seront paralyses, sauf 
action adequate. Votre propre consommation Internet risque done de souf- 
frir. 

Malgre l'ensemble des contraintes qui peuvent de prime abord paraitre con- 
sequentes, l'amelioration constante de la qualite des connexions haut debit 
rend reellement viable l'hebergement d'un service classique a domicile, pour 
peu que les telechargements soit deportes sur un autre site. 



Adresse IP et nom 



Avant meme de vous lancer a la conquete de PHP 5 et du Web, il faudra 
vous preoccuper des problemes d'adressage et de nom. 

Principe 

En regie generale, pour acceder a un serveur, nous faisons appel a son nom : 
cela nous parait logique et naturellement le plus adapte. Cependant, au sein 
du reseau, les serveurs ne sont pas designes par ce nom, mais par une adresse 
numerique plus simple a manipuler. Cette adresse est utilisee pour trouver la 
route entre un serveur et votre propre ordinateur. Pour assurer la correspon- 
dance entre les deux, le reseau Internet dispose done d'un systeme 
d'annuaire, le DNS (Domain Name Server). 

Jusque-la tout est simple. Helas, cette mecanique est lourde et suppose que 
la correspondance entre un nom et son adresse ne change que tres rarement. 
Or, avec l'explosion du nombre d'Internautes, les besoins en adresses sont de 
plus en plus difficiles a satisfaire (celles-ci sont en effet composees de quatre 
nombres compris entre 0 et 255, le nombre d'adresses disponibles est done 
limite). Pour resoudre ce probleme, les fournisseurs d'acces mutualisent leur 
pool d'adresses entre tous leurs clients. Apres tout, nous ne nous connectons 
pas tous au meme instant. 

Cette pratique ne pose aucun probleme en soit, notamment pour les con- 
nexions par modem, cependant un service, pour etre contacte doit pouvoir 
etre localisable de maniere liable a chaque instant. Le changement perio- 
dique d'adresse impose par le fournisseur d'acces est done problematique. 

Naturellement, de plus en plus de fournisseurs commencent a proposer une 
adresse IP fixe. Neanmoins, cette option reste encore minoritaire. Que faire 
alors si vous n'etes pas l'heureux possesseur d'une adresse IP fixe ? 

II existe par chance des services simples qui proposent un acces a leur 
annuaire (et done a un nom) et un outil pour effectuer automatiquement les 
mises a jour en cas de changement. Ces annuaires, configures pour ce type 
de fonctionnement sauront done a chaque instant vous retrouver, vous et 
votre adresse IP. 

Selon que vous soyez sous Linux ou Windows (il existe aussi des outils equi- 
valents sur Mac) differents outils permettent cette mise a jour dynamique. 
La plupart du temps, ceux-ci peuvent se connecter a plusieurs services 
d'annuaire. N'hesitez done pas a explorer les possibilites de chacun. Dans 
tous les cas, les logiciels de mise a jour doivent etre lances des le demarrage 
et rester actifs. 



SERVICE DynDNS 

Les services d'annuaire dynamique sont legions, le 
plus connu est DynDNS a tel point que ce terme est 
devenu generique et designe globablement un ser- 
vice d'annuaire dynamique. 
Certaines societes proposent une prestation plus 
complete et vous permettront d'obtenir un nom 
plus seduisant, mais le principe reste le meme. 
► www.dyndns.org 
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Microsoft Windows 

Bali DynDNS est un logiciel simple et efficace, il est disponible en fran- 
qais et supporte plusieurs services parmi les plus connus. 



• Doll Dynamic D^5 : Update your dynamic IP 



Main Sotup |r>oiy | IP Choice | Help | History | FAQ. | About | 
|RHiviiv1 Service 2 | Service 3 | Serviced) Service 5 | 

lyinlnsnrij Uesr/Pass : | 

Backup MX: | 



r Rk 



l IpilnlK yiilll 



r 



dneq.org 
dhs.org 
myip.us 
ovh.com 
no-ip. com 



Wildcards r 



T 



Update IP in database it necessary 



Status: IP Changed? 



Mem/Detect: 



1 (S 



Welcome in Bat Dynamic DNb 



I* 



Figure A-1 Fenetre de configuration de Bali DynamicDNS 

Plusieurs services peuvent etre utilises simultanement mais la plupart 
du temps un seul sera utilise. Lorsque le logiciel est lance une icone est 
accessible dans la barre des taches. 

► http://www.baliciel.com/softwares/baliddns.htm 



Linux 

Sous Linux, le logiciel ez-ipupdate est particulierement efficace. II peut 
etre lance simplement en arriere-plan et gere tout seul. Le fichier de 
configuration est simple et le logiciel livre avec des exemples. 

service-type=easydns 
user=XXXX 

host=mon-nom-a-moi .com 

interface=ethl 

wi ldcard=on 

cache-fi le=/tmp/ez-ipupdate. cache 

# uncomment this once you have everything working how 
you want and you are 

# ready to have ez-ipupdate running in the background 
all the time, to stop it 

# you can use "kill all -QUIT ez-ipupdate" under "linux. 

daemon 

II est aussi possible de ne pas lancer ez-update sous forme de demon et 
le coupler aux scripts appeles par le client DHCP directement lorsque 
I'adresse est attribute. La procedure depend alors de votre client. 



► http://ez-ipupdate.com/ 



Installation proprement dite 

Une fois votre machine correctement accessible par tous, encore faut-il avoir 
un serveur web installe, deux installations types sont proposees, sous Micro- 
soft Windows et sous Linux. 

Sous Microsoft Windows 
Installer Apache 

reinstallation d' Apache sous Windows est reellement un jeu d'enfant. Un 

> http.//httpd. apache. org installeur est disponible et l'installation se resume a une sequence de boites 

de dialogue elementaires. 
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, 7 Apache HTTP Server - Installation Wizard 




Welcome to the Installation Wizard for 
Apache HTTP Server 1.3.29 



The Installation Wizard will install Apache HTTP Server 1 .3.29 
on your computer. To continue, click Next. 



WARNING: This program is protected by copyright law and 
international treaties. 



I 

< 



Figure A-2 

Demarrage de I'installation d'Apache 
sous Microsoft Windows 



icr Apache HTTP Server - Installation Wizard 



Server Information 

Please enter your server's information, 

Network Domain (e.g. somenet.com) 

Server Name (e,g, www, somenet.com): 
[pel. home 

Administrator's Email Address (e.g. webmaster@somenet.com): 
|admin@home 

Install Apache HTTP Server programs and shortcuts to: 

(* Run as a service for All Users ~ Recommended 

C Run when started manually, only for me (Stephane Mariel) 

Instal!5hield 



<Back 



I 



Cancel 



Figure A-3 

Fin de I'installation d'Apache 
et selections des options 



En phase de test, le plus simple est cependant de ne pas utiliser la possibilite 
offerte d'integrer Apache en tant que service et de se contenter de demarrer 
celui-ci a la main. 







'^fj Documents ► ^ :t 

^ Rechercher ► J u.u..c u ^u. * 


& Aide U^B\ 

J] Executer... .r 1 ► 


_7j Configure Apache Server ► ^ Restart 
rj Help I'm Stuck! 


(Ql Arreter... * •"* T <*J B > 


I^J.LUJ.I,UI].lllJJJMJvl\ 


iiBDemarrer ^ ® ^| 3* V* | (Bl"-"--! IM"» 


■■ iaa"'"-i i — 1 ajphps 1 S 



Figure A-4 

Lancement d'Apache 
depuis le menu Demarrer 
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A RETENIR Localhost 

On a vu precedemment que pour pouvoir nommer 
une machine il faut un annuaire. Toutefois, il existe 
un nom, disponible par defaut et qui designe la 
machine locale, que celle-ci soit connectee au 
reseau ou non. Ce nom est localhost, il est uti- 
lise par tous les systemes d'exploitation. 



^installation realisee, il est possible de verifier immediatement le bon fonc- 
tionnement du serveur avec n'importe quel navigateur. Une page par defaut 
apparait alors. La racine du site web est positionnee sur le repertoire 
c:\Program files\Apache Croup\Apache\htdocs. 



I Page de test de {'installation d'Apache - Mozilla {Build ID: 2004031616} 



File Edit View Go Bookmarks lools Window Help Debug QA 



□Jxj 



» |t " "3 11 | -A- http://localh.ost/ 



^.Search 



Sivous lisez cette page, c'est que les proprietaires de ce domaine viennent d'installer le 
serveur web Apache avec succes Us doivent maintenant ajouter du contenu a ce repertoire et 
remplacer cette page, ou bien faire pointer le serveur vers l'endroit ou se trouve le contenu 
reel du site. 



Vous voyez cette page au lieu du site attendu ? 

Vous voyez cette page parce que radministrateur du site a modifie la configuration de ce 
serveur Web. Veuillez contacterl'a(linuusri atem du .site concenie. La Fondation Apache 
(Apache Software Foundation), qui produit le logiciel Apache utilise par ce site, n'a rien a 
voir avec la maintenance de ce site et ne peut intervenir sur sa configuration. 



La documentation Apache est incluse dans cette distribution. 

Le webmaster de ce site peut Hbrement ufiliser 1'image ci-dessous sur un site web utilisant le 
logiciel Apache. Merci d'avoir choisi Apache ! 



"f^S 1 /s. 



Figure A-5 Test d'Apache sous Microsoft Windows 



Installer PHP 5 

PHP dispose lui aussi d'un installeur. Celui-ci n'est pas disponible pour 
PHP 5, mais surtout, Installation realisee n'est pas satisfaisante. II est pre- 

> http.//ww.php.net ferable de telecharger le fichier . zi p comprenant l'integralite des extensions, 

le programme PHP en ligne de commande et les modules PHP. 

La procedure consiste a decompresser cette archive dans un repertoire. Con- 
trairement a certaines pratiques decrites sur Internet, il est vraiment decon- 
seille d'utiliser la racine de votre disque. Le repertoire d'installation 
d'Apache est beaucoup plus indique. II suffit done de creer un sous-reper- 
toire php a l'interieur puis de tout decompresser. 

La encore on evitera de suivre les modes d'emploi fantaisistes parfois pro- 
poses. Aucune des librairies PHP n'est a copier dans le repertoire systeme de 
votre ordinateur. Seul le fichier php .i ni -recommended doit etre copie dans ce 
repertoire (sous Windows 2000 et XP, il s'agit de c:\winnt) et renomme 
php.ini. 
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^JWinZip - php-S.0.0RC2-Win32.zip 



File Actions Options Help 



Open 



Checkout Wizard 



I Type ^ 



Helvetica-BoldOblique.afm 
*1 Helvetica-Oblique, afm 
wjlcdxsr.afm 
w Symbol ■afm 
«] Times-Bold, afm 
«] Times-Boldltalic.afm 
*1 Times- Italic, afm 
«] Times-Roman, afm 
*1 Zapf Dingbats, afm 
~°l php.exe 
Hphp-cgi.exe 
~°l php-win.exe 
@cpl250.cpg 
Qcpl251.cpg 
|*]cpl252.cpg 
Qcpl253.cpg 
[«]cpl254.cpg 
S]cd1255.cdo 



File: 

C Selected files 

All files 
T Files: I 



I - Overwrite existing files 

I - Skip older files 

W Use folder names 

I"" Open Explorer window 



B Q Program Files 
\ Q A-Prompt 
1+] O adagide — 
ffl O Adobe 
; Pj Advanced For 
B O Apache Group 
- _j| Apache 
Q bin 

J ^ C i 1 '," |in ' 



IT 



Selected 0 files, 0 bytes 



Total 194 Files, 18 628KB 



^jnjxj 



J?jxj 




J 



Help 



I 

< 



Figure A-6 

Extraction des binaires PHP 
pour Microsoft Windows 



Avant de tester notre installation, quelques modifications doivent etre 
apportees, d'une part au fichier de configuration Apache et d'autre part au 
fichier de configuration de PHP. 

Dans le premier cas, il s'agit de s'assurer qu Apache saura utiliser PHP. Voici 
les quatres modifications cles a apporter au fichier httpd.conf (celui-ci est 
situe dans le repertoire C:\Program Files\Apache Group\Apache\conf et peut 
etre modifie et teste tres simplement en utilisant les raccourcis du menu 
Demarrer) : 

1 Ajouter la ligne suivante a la liste des modules : 

LoadModule php5_module php/php5apache.d~n 

2 De meme pour : 

AddModule mod_php5 .c 

3 Declarer l'interpreteur PHP pour les fichiers avec l'extension PHP dans 
la section <If Module modjnime.o 

AddType application/x-httpd-php .php 

4 Ajouter index. php comme alternative dans la section <IfModule 
mod_di r.o 

Di rectorylndex index.html index. php 
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1 Enfin pour php.ini, il s'agit de preciser le repertoire ou sont situees les 

2 extensions. Dans PHP Saloon, nous utiliserons gd, sqlite, dom et xslt entre 
il. autres. Pour simplifier, nous allons demander le chargement automatique de 

celles-ci, ce qui nous evitera d'utiliser dl () dans le code de PHP Saloon. 

J= Pour ce faire, il suffit de modifier le chemin des extensions : 

3 

- 1 extension_di r = "c:/program files/apache group/apache/php/ext" 

Puis de lister les extensions a charger par defaut : 

extension = php_gd2.dll 
extension = php_xsl.dll 

DOM et SQLite sont charges d'emblee, il suffit done d'ajouter GD et les 
transformations XSLT. Ces quelques operations realisees, PHP est pret a 
etre teste. II ne reste qua demarrer Apache et tester avec un fichier tout 
bete : 

<? phpinfo() ?> 

On constate alors l'affichage du detail de la configuration PHP et avec sou- 
lagement, qu'il s'agit bien de la version 5 ! 



Figure A-7 

Test d'integration 
entre Apache et PHP 5 



1 pi? php 


info() - Mo2illa {Build ID: 2004031616 






File 


Edit View Go Bookmarks Tools 


vyjndow Heo Debug QA 


I ± 


- |fe • ^ r}| | & http://lx.tvKt/rfo pf« ^Search | ^ 


* s 










PHP Version 5.0.0RC2 


Php) 














System 


Winrtnws NT RTF fi (1 hi likl 21 91 








Build D ue 


Apr 25 2004 12.10.13 








Configure Command 


cscript/nologo confrgure.js"-enable-snapshot-build" 
"-witti-gd=shared" 








Server API 


Anarhe 








Vil lual Dil ecloiy Suppui 1 


enabled 








Configurafion File (plipjni) Path 


C:\WINNTIphp.ini 








PHP API 


20011224 








PHP Extension 


20040412 








Zend Extension 


220040412 








Debug Build 


no 








I mead satety 


enabled 








IPv6 Support 


enabled 








Registered PHP Streams 


php. file, http, ftp. comprcoczlib 








Registered Stteatn Socket 
Ttanspotts 


top, udp 














This program makes use nfthe 7enr1 Scripting 1 angnage Fngine _ Powered By 
Zend Enqine V2.0.0RC2. Copvriqht (c) 1 998-2004 Zend Technoloaies 




d 


•\ 


I d 


Done 
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Sous Linux 



Installer Apache 

Le plus souvent, Apache est deja installe par les distributions Linux. Si tel 
n'est pas le cas, la procedure sera encore plus simple et expeditive que sous 
Microsoft Windows. 

Si vous utilisez Debian, la commande suivante suffira : 
apt-get install apache 

Vous pouvez aussi utiliser synaptic. 



* „* Synaptic Package Manager 



File Actions Package View Preferences Help 



<^5 






Find: japa| 




Refresh 


Upgrade System 


Apply 







Show: All Packages 



^.Filters.. 



s 


Package 


Installed Version 


Latest Version 


Required 


aolserver4-nscache 
aolserver4-nsopenssl 
□ ap-utils 




1.5-1 

3.0betal2-l 
1.3.3-1 




m 


apache 


1.3.29.0.2-4 


1.3.29.0.2-4 


1 


■ apache-common 

|~1 apache-dbg 

B apache-dev 
i — i i i_ . 


1.3.29.0.2-4 
1.3.29.0.1-3 


1.3.29.0.2-4 
1.3.29.0.2-4 
1.3.29.0.2-4 


2E 






1 




H 



Common Description Dependencies Installed Files Expert 



Package: 


apache 






Versatile, high-performance HTTP server 




Status: 


n Installed 




Maintained 


Debian Apache Maintainers <debian-apache@lists.debian.org: 




Priority: 


optional 




Section: 


World Wide Web 





Package Control 

+ Upgrade 



■ Remove 



No Changes 
^Configure 



Figure A-8 

Installation d'Apache 
sous Debian avec synaptic 



|14805 packages listed, 632 installed, 0 broken. 0 to install/upgrade, 0 to remove; 0 will be used 



Figure A-9 

Installation d'Apache 
avec rpmdrake 
sous Mandrakelinux 



Pour la distribution Mandrakelinux, l'utilisation de rpmdrake et une simple 
case a cocher devraient resoudre le probleme. La plupart du temps, la racine 
du site web est positionnee sur le repertoire /var/www. 



MiMiulr-ika JU g 



Installation de paquetages logiciels 



Rechercher : parmi les noms 



(• Choix Mandrake 

C Tous les paquetages, classement alphabetique 



r 


Tous les paquetages. par groupe 






> Developpement 




[■ 


Environnement graphique 






1 


Serveur 






[ 


Station de travail 








Resultatsde la recherche 


□ 






apache-l,3.29-lmdk 







P Informations normales 
(• Informations maximales 



apache2-2 0 48-6mdk 
apache2-common-2.0 48-f 
apache2-devel-2 0 48-6m 
apache2-manual-2. 0.48-6 
apache2-mod_auth_exte 



Norn : apache 

Version : 1.3.29-lmdk 

Taille: 14 Ko 

Media : Installation CD 

Version actuellement installee : (aucun) 

Intitule : The most widely used Web server on the Internet. 

Description : Apache is a powerful, full-featured, efficient 
and freely-available Web server. Apache is also the most 



Des paquetages supplementaires sont necessaires 



Pour satisfaire les dependances. Ie(s) paquetage(s) suivant(s) 
doivent aussi etre installes : 



apache2-common-2.0.48-6mdk. apache-conf-2.0.48-2mdk. 
apache-modules-1.3.29-lmdk. Iibapr0-2.0.48-6mdk. libdb3.3-3.3 ll-17mdk. 
apache2-mod_auth_mysq | jb mml-1.3.0-3mdk 

a p a c h e 2- m o d_a uth_p g sql- 

apache2-mod_auth_radiu! 



aDache2-mod auth remote-2.0.48 1.0-lmdl I |Dackaaei. 
Aide Selectionnes : 0 Ho ..' Place libre sur disque 1095 Mo 



tions. 

EAR), Shared 
several 



available in 
551 module 

:hesto 
tpage 



Installer PHP 5 

Pour PHP 5, les choses sont un peu moins simples, car a ce jour aucune dis- 
tribution n'integre encore le package associe a PHP 5. La solution la plus 
simple consiste alors a compiler soit meme. 

Loperation nest pas complexe en soi, mais faute d'habitude on peut etre 
amene a tatonner un peu pour retrouver les outils necessaires a la compila- 
tion ou a l'activation des extensions PHP souhaitees. II s'agit bien sur des 
outils de developpements traditionnels (compilateur, en-tetes systemes) mais 
les en-tetes de librairies deja installees seront le plus souvent necessaires (par 
exemple pour GD si Ton souhaite obtenir le support des images JPEG, 
PNG...)- Toutefois, dans la plupart des cas l'outil « configure » livre avec 
PHP saura indiquer les elements manquants. 

La procedure de compilation en elle-meme est sans surprise, voici la 
sequence d'operation utilisee pour PHP Saloon : 

./configure --with-sqlite --with-apxs --with-xsl --with-gd --with-zlib 

--with-jpeg-di r=/usr 

make 
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D'autres extensions peuvent naturellement etre ajoutees. Pour plus de detail, 
consulter le fichier INSTALL ou l'aide de configure. Au terme de la compila- 
tion, l'installation est automatisee, il suffit d'invoquer la commande : 

| make install 

La configuration d' Apache est automatiquement modifiee et PHP est pret a 
etre utilise. Comme sous Windows, on pourra sen assurer avec un simple 
phpi nf o() . II peut toutefois etre utile d'ajouter i ndex . php comme alternative a 
i ndex . html (voir l'installation Windows). 



Tester PHP Saloon 

Que faire une fois ces installations realisees ? Une toute derniere operation : 
copier le code de PHP Saloon a la racine de votre site web. Quelques ajuste- 
ments en termes de droits sur les fichiers peuvent etre necessaires sous Linux 
mais, sauf complication imprevue, PHP Saloon devrait etre directement 
operationnel. 



Pear et les extensions 
standards de PHP 5 



annexe 




Une des richesses de PHP est de ne pas exister seul en tant que langage, 
mais, au contraire, de proposer en standard un environnement complet dote 
de multiples extensions qui couvrent l'integralite des domaines de develop- 
pement. 

En outre, avec Pear, PHP dispose d'un repertoire encore plus ouvert de 
classes et d' extensions, a la maniere de CPAN pour Perl. 



Ces extensions sont integrees a la distribution PHP. Ce qui veut dire que, 
sous reserve d'etre activees au moment de la compilation de l'interpreteur 
PHP, celles-ci sont disponibles sans autre formalite. 

Cependant, cette reserve est importante, car dans le cas des hebergements 
mutualises, l'utilisateur ne compile pas lui-meme PHP, mais utilise une ver- 
sion partagee par tous les clients de l'hebergeur. En fonction des choix de 
celui-ci, certaines extensions dites standards peuvent done s'averer indispo- 
nibles. 

Pour eviter les desagrements apres coup, une fois la commande d'un heberge- 
ment passee, il est important de se renseigner au prealable. La plupart des 
hebergeurs sont transparents sur leurs choix et proposent une page d'informa- 
tion utilisant la fonction phpi nfo() de PHP pour lister les extensions activees. 

Certaines extensions sont par nature directement integrees a PHP, e'est le 
cas des operations sur les tableaux. 

Le tableau suivant liste les extensions disponibles. 



Les extensions standards 



Extension Domaine d'action 




apache 


Quand PHP est utilise sous forme de module pour le serveur Web Apache, cette extension fournit des fonctions permet- 
tant d'acceder a des fonctionnalites specifiques d'Apache. 


arrays 


Cette extension regroupe I'integralite des operations sur les tableaux (fusion, tri, transformations diverses). 


bcmath 


BC (Binary Calculator) est une extension qui permet d'effectuer des calculs avec une precision sans limite (traditionnelle- 
ment, les entiers sont stockes sur 32 bits uniquement et les reels le sont avec une precision donnee qui peut etre insuffi- 
sante). 


bz2 


bzip2 est un utilitaire et une librairie de compression. Cette extension permet de manipuler ce type d'archives compres- 
sees. 


calendar 


L'histoire a connu un certain nombre de calendriers, et encore aujourd'hui, certains pays ont recours a leur propre calen- 

rlripr 1 'pxtpn<;inn ra 1 pnrla r nprmpt H'pffprti ipr Hpc; rnn\/pr<;inn<; pntrp tni k Ipt; ra Ipnrlripr*; 

HI ICI. I_ CALCI 1 J \ \J\ 1 Lu 1 CI IUu 1 L/C 1 1 1 1 C L U C 1 1 Cl_ LUCI UCJ \.\J\ 1 VCI jIUI 1 j CI 1 U C LUUj ICj \-C\ 1 CI l\A\ ICI J. 


com/. NET 


Les amateurs de la plate-forme Microsoft Windows pourront avec cette extension invoquer les composants COM disponi- 
bles sur leur OS prefere, voire charger des modules .NET. 

Attpntinn la \/pr<;inn rlKnnnihlp HarK PHP R n'p<;t nat; rpllp Hp la \/pr<;inn A 

niici iliuii, la vci jivji i uuijvji i iuic uai i j i i 11 _/ 11 cjl uqj v_ci ic lic i q vcijiuii i . 


classes/objects 


Toutes les fonctions d'information sur les objets et les classes sont reunies dans cette extension. 


clibpdf 


Une des extensions disponibles en PHP pour creer dynamiquement et manipuler les documents PDF. 


ctype 


Cette extension propose des fonctions qui sauront ranger vos chames de caracteres dans differentes categories (numeri- 
ques, majuscules et minuscules). Meme si elle peut paraitre redondante avec certaines instructions PHP plus connues, 
cette extension est en realite tres rapide. 


curl 


Avec fopen() et les streams, PHP est en mesure de se connecter sans difficulty a tout type de serveur distant, mais une 
fois la connexion effectuee, I'interpretation du protocole (HTTP, FTP ou autre) peut etre complexe a realiser manuelle- 
ment. L' extension curl propose toute une serie de fonctions pour simplifier le travail et ainsi acceder, le plus simplement 

Hii mnnrlp 3 tout t\/np Hp Qprupurc rlpnnit; PHP uniK <;nnhaitP7 snrpnpr rliffprpntp^ <;nurrp<; Hp rnntpnut; rpttp pytpn<;inn 

UU 1 1 1 Ul 1 UC, CI LUUl Ly 1JC UC JCI VCUlJ UCUUlJ 1 1 II . _> 1 vUUj jUUIIul LCi. CIUI CUCI U 1 1 1 CI C 1 1 LCj jUUKCj UC *~<J\ 1 IC 1 1 U J, CALCIlJlUII 

peut vous etre tres utile. 


dba 


Cette extension permet d'acceder aux bases de donnees de type DBM stockees sous forme de fichiers. 


date/time 


Disponible en standard, cette extension integre une foule de fonctions pour manipuler les dates et le temps en general. 


dbase 


dbase est un autre systeme pour stacker des enregistrements dans un fichier. Cette extension fournit I'acces a de tels 
fichiers. 


dbx 


dbx est ce qu'on appelle un abstraction layer, c'est-a-dire une interface commune a plusieurs systemes, ici des bases de 
donnees. Ainsi, au lieu d'utiliser les instructions specifiques a MySQL ou SQLite, les fonctions de I'extension dbx permet- 
tent d'attaquer indifferemment des bases des deux types. La plupart des bases compatibles avec PHP le sont egalement 
avec dbx. 


dio 


Cette extension permet d'effectuer des entrees et sorties a un niveau plus bas que les streams PHP comme le propose la 
section 6 du standard POSIX. A reserver aux experts pour des cas bien particuliers. 


di rectories 


Toutes les fonctions de manipulation des repertoires sont reunies ici. 


dom 


La fameuse extension DOM, dont PHP Saloon fait un large usage, et qui implemente I'ensemble de I'API definie par le 
W3C pour les documents HTML et XML. 



Fxtpnsion 


Domains d'action 


errors/logging 


Cette extension regroupe les fonctions qui pemettent d'identifier et de rapporter les erreurs lors de I'execution d'un pro- 
nrammp PHP 

CJ 1 CI 1 1 1 1 1 1 C 1 Ilia 


exi f 


FXIF ( Fxrhannpahlp Imanp File Format^ est un stanriarri nour stnrkpr Ips informations psspntipllps H'unp imanp fnntam- 

L-/\l 1 LL.AdlCIIICJCCII>JIC 1 1 1 1 CICj C 1 1 1 C 1 \J 1 1 II CI L/ CJL U 1 1 D LCI 1 1 \A CI 1 CI IJ \J CI 1 D LUL l\C 1 ItJ 1 1 1 1 \J 1 1 1 1 CI I 1 yj 1 1 J CJJCI ILICIICJ \A LI 1 1 C 1 1 1 1 CILJC \ 1 1 \J LCI 1 1 1 

ment JPEG). De nombreux appareils photo numeriques se servent de ce standard. 


fam 


Disponible uniquement sous Microsoft Windows, cette extension permet de suivre les modifications de certains fichiers 
automatiquement. 


f rontbase 


Une extension pour acceder aux bases FrontBase. 


fdf 


Cette extension donne acces a I'interface d'Adobe pour manipuler les fichiers FDF utilises par Adobe Forms. 


filepro 


Une extension pour acceder aux bases FilePro en lecture uniquement. 


fi lesystem 


Disponible par defaut, cette extension regroupe toutes les fonctions d'acces aux fichiers et, plus generalement, au sys- 
teme de fichiers lui-meme. 


ftp 


Cette extension permet d'acceder a un serveur FTP depuis un programme PHP. 


functions 


Avec cette extension, il est possible de manipuler toutes les fonctions de maniere avancee. 


i mage 


GD est line hihlinthpnup nranhinnp dont imp version pst intpnrpp k PHP Flip nprmpt dp maninnlpr diffprpnts formats 

VJ Ly C J L U 1 1 C UlkJIIUlllt^UUtl \A 1 ci IJ 1 1 1 \J \Ji\^ UUI 1 L U 1 1 C VCI JIUI CJl 1 1 1 l^*_l 1 C^C CI 1 III. 1 1 1 vZT I J C 1 1 1 1 C l UC IIICIIIILJUIC7I l_l 1 1 1 C 1 ^ 1 1 l J IUI 1 1 !□ Lj 

d'image et d'en creer dynamiquement via des fonctions integrees a cette extension. 


gettext 


Nous I'avons utilisee dans PHP Saloon. GNU Gettext est un outil d'internationalisation. 


gmp 


A I'instar de BC, GMP est une bibliotheque permettant de manipuler des valeurs en precision arbitraire, mais uniquement 
pour les entiers, dans le cas de GMP. 


http 


Manipulant cookies et headers, cette extension est a meme de modifier les parametres de la connexion HTTP. 


hwarn - 

1 IVVCLIJ 1 


1 Inp PYtpncinn nnnr ^rrprlpr ^11 cwotpmp HvnprWpvp 

(J 1 IC CALCI 1 -) \\Jl 1 IJWUI C1L.L.CLJCI CI U J V J LCI lid IIVIJCIVVCIVC. 


i conv 


(~pttp pxtpnsinn nprmpt Hp riisnospr rips fnnrtinnnalitps rip ronvprsion pntrp pnrndanps nour Ips rarartprps 

V_ L III. CALCI IJIUI 1 L/CI 1 1 IC I L4C LI U LI LUC 1 UCJ ILHICLILSIIIIdlllCj LIC CLsllVClJlLSII CI III C CIICL/L1CILJC.J UUUI ICJ LCIICILLCIC3. 


i map 


Contrairpmpnt a cp nup Ip nom nnnrrait laisspr rrnirp Ips fnnrtions rip I'pxtpnsion iman np sp limitpnt nas a rp spuI nrnto- 

v-L/IILICIIICIIICIIL Q IC LI LI C IC 1 ILSI 1 1 IJ U U 1 1 CJ 1 I IQI JJCI LI UN C/ ICJ IUI ICLIl/l IJ LI C 1 C A LCI 1 JlUI 1 J 1 1 1 GLLJ IIC JC 1 1 1 1 1 1 LCI 1 L IJ CU CI IC JCUI Ul ULU 

cole mais supportent aussi P0P3, pour la releve du courrier, et NNTP, pour I'acces aux forums de discussion. La plupart 
des outils PHP de lecture d'e-mails en ligne reposent sur cette extension. 


informix 


Une extension pour acceder aux bases Informix. 


ingres_ii 


Une extension pour acceder aux bases Ingres. 


interbase 


Une extension pour acceder aux bases InterBase. 


i rcg 


Cette extension s'interface a IRC (Internet Relay Chat, un systeme de chat en reseau,) via le logiciel IRCG. 


ldap 


Cette extension permet d'interroger et de modifier les annuaires LDAP, notamment Active Directory. 


mail 


Cette extension consiste en realite en une fonction principale qui permet d'envoyer un e-mail depuis PHP. 


math 


Disponible par defaut, cette extension regroupe I'ensemble des fonctions et constantes mathematiques. 
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multibyte string 


Traditionnellement, en Europe occidentale, les caracteres sont stockes sur un seul octet. Toutefois, cela n'est pas possible 

nni ir Hiffprpntpc I a nni ipc Dane; rp rac il pet fait iic^np Hp rhainpc Hp rarartprpc nn nh icipi ire nrtptc ennt acenripe a rhani ip 

UUU I U 1 1 1 CI CI I LC_> 1 a 1 IUUCj. L/a 1 \D LC Ld D, 1 1 Cj L 1 a 1 L UjcIUC UC LI 1 d 1 1 ICj UC Ld 1 d L LCI Cj UU Ul UjICUI j UL LC Lj JUI 1 1 diiULI Cj d LI Id UU C 

caractere. Cette extension permet de manipuler de telles chaTnes. 


mil, i y p l 


f~pttp PYtpncinn nprmpt H'arrpHpr aiiY fnnrtinnc pt alnnrithmpc Hp rhiffrpmpnt Hicnnnihlpc Hanc la lihrairip mrrunt 

V_C L LC CALCI 1 J IUI 1 UCIIIICL U dLLCUCI d UA 1 Ul IL LI Ul 1 J CL d 1 U Ul 1 LI III ICj UC LIIIIIICIIICIIL UIjUUI IIUICj Ud 1 li Id 1 IUI d 1 1 IC II 1 L 1 y U L . 


mcve 


MCVE est le successeur de Red Hat CCVS et n'est pas disponible sous Microsoft Windows. Elle permet a n'importe quel 

llniy HnntliniiY H'nhtpnir i in ni imprn H'ai itnricatinn hanrairp nni ir la \/pntp a Hictanrp cane naccpr nar i in intprmpHiairp 

UIIIA, UUIIL LIIIUA, U UUICIIII LI 1 1 IIUIIICIU U d U LUI 1 id LI Ul 1 UdllLdllC UUUI Id VCIIIC d UliLdllLC jdllo UCIjjCI Udl Ul 1 1 1 1 LCI 1 1 ICU Idl 1 c. 


mh els h 


mha<;h nprmpt Hp ralnilpr Hpc cinnati irpc mi Hpc Hpc pt Hp vprifipr ainci I'ai ithpntiritp Hp Hnnimpntc 

II II 1 di> 1 1 UCIIIICL UC Ld 1 LU 1 CI UC3 i 1 U 1 Id LU 1 C J UU UO LI C J CL UC VCIIIICI d 1 1 1 i 1 1 dULIICIILILI LC UC UULU 1 1 ICI 1 ID. 


Ml I MIC Midy I L, 


1 pc fnnrtinnc Hp rpttp PYtpncinn nprmpttpnt Hp Hptprminpr Ip rnntpni i H'i in firhipr a la maniprp Hp la rnmmanHp fi 1 p 

LCj 1 Ul IL LI Ul Id UC LC LLC CALCI Id 1 Ul 1 UCI 1 1 ICI LCI 11 UC UC LCI 1 1 1 1 1 ICI IC LUI 1 ICI IU U UN 1 1 LI 1 1 CI d ICI 1 1 1 d 1 1 1 CI C UC Id LU 1 IlllldllUC 1 1 1 C 

sous Unix. 


mi ng 


Ming est une bibliotheque Open Source qui permet de creer des documents Macromedia Flash. L'extension PHP permet 

H'arrpHpr a rpc fnnrtinnnalitpc 

U dLLCUCI d LCi 1 Ul ILLIUI II Id 1 1 LC J. 




1 In pncpmhlp Hp fnnrtinnc nine nil mninc hptprnr litpc Hnnt Ipc fnnrtinnc; Hp rn Inricatinn Hi i rnr\p PHP 

Ull CIIjCIIIUIC UC IUI ILLIUI Id UIUj UU IIIUIIlJ 1 IC ICI ULI 1 IC J, UUIIL ICS IUIILLIUIIj UC LUIUI 1 id LIUI 1 UU LUUC r nr. 


n n i uy U i c d I Lll 


f~pttp pytpneinn c'intprfarp a\/pr Ip mntpiir Hp rprhprrhp mnnf-in^parrh fp mntpiir npiit ptrp iitilicp cur un intranpt 

V_C L LC CALCI 1 jIUI 1 3 III LCI 1 dLC a VCL IC II IU LCUI UC 1 CLI ICI LI IC 1 1 1 1 IUVJU JCa 1 LI 1 . V_C II IU LCUI UCU I CLIC U LI 1 1 jC jUI Ull IIILIdllCl. 


msession 


Lorsqu'un site est tres populaire, il peut s'averer necessaire d'equilibrer la charge entre plusieurs serveurs. Dans ce cas, les 

cpccinnc traHitinnnpllpc Hp PHP np npi iwpnt fnnrtinnnpr rar Ipc rpm iptpc Hpc i itilicatpi ire ennt traitppc nar nh icipi ire cpr- 

jCjjIUIIj 11 dU 1 LIUI II ICI ICj UC Illr IIC UCUVCIIl 1 Ul ILLIUI II ICI, Ldl ICj ICUUCLCj UCj ULIIIidLCUli 5UIIL LldlLCCj Udl UIUjICUIj jCI 

veurs. L'extension msessi on permet de s'interfacer avec un serveur de session et ainsi contourner le probleme. 


msql 


1 Inp pytpneinn nni ir ^\rc(^(\(^T aiiY haepe IVI^OI 

UIIC CALCIIjIUII UUUI dLLCUCI dUA UCIjC3 IVIJL/L. 


mssql 


Une extension pour acceder aux bases Microsoft SQL Server. 


mysql 


L'extension probablement la plus connue de PHP. Elle permet d'acceder aux bases MySQL, quelle que soit la version du 
serveur. 


mysqli 


Cette extension permet de tirer profit des ameliorations de I'interface d'interrogation, disponible dans les serveurs MySQL 

wprcinn /II oil <u inpripi irp 

VCI jIUI 1 H. 1 UU jUUCI icui c. 


1 1 L U I jti 


fpttp pYtpncinn n'pet utilp nii'a tpiiy nni cm ihaitpnt Hp\/plnnnpr Hpc annliratinnc pn mnrlp rnncnlp cniic llniy Flip nprmpt 

\_CllC CALCI IjIUII II OL ULIIC UU d LCUA LIUI bUUI ldl LCI 11 UCvCIUUUCI UCj dUUI ILd LIUI 1 3 CI 1 IIIUUC LUIIjUIC jUUj UIIIA. tllC UCIIIICL 

de piloter le terminal en utilisant la celebre librairie nCurses. 


1 1 c LWU I l\ 


f~pttp PYtpncinn intpnrp imp trpc lamp nartip Hpc fnnrtinnc rpcpaii Hicnnnihlpc cnnc Ipc c\/ctpmpc llniy Pmir nine Hp fnnr- 

V_CllC CALCI 1 jIUI 1 III LCU IC UIIC LI Ci ml UC UdlllC UCj 1 U 1 1 L LI U 1 1 j 1 CjCCI U Ul jUUI IIUICj jUUj ICj jy j ICI 1 ICJ UIIIA. TUUI [J 1 Uj UC 1 Ul IL 

tionnalites, il est preferable de regarder l'extension sur les flots (streams). 


oci 8 


Ppttp PYtpncinn nprmpt Hp cp rnnnprtpr aiiY haepe Orarlp /\/prcinn S pt uprcinnc ci inpripi irpcl 

\_CllC CALCI IjIUII UCIIIICl UC 3C LUI II ICL LCI d U A Ud jcj \J 1 dLI C \VClJlUII O CL VClJlUllJ jUUCIICUICj^. 


odbc 


Cette extension permet de se connecter a toute base de donnees disposant d'un driver ODBC. 


openssl 


Cette extension permet d'utiliser directement I'ensemble des possibilites de la librairie SSL OpenSSL pour crypter des con- 
nexions. 


oracle 


II s'agit de l'extension historique pour se connecter a Oracle. Sauf recours a une version prehistorique d'Oracle, l'exten- 
sion oci 8 est a preferer. 


output control 


Cette extension permet de controler de maniere precise le flot de sortie produit par I'execution du programme PHP 
(incluant les elements statiques). 
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CL 



Extension 


Domaine d'action 


n\/p rl na rl 

UV CI 1 U CLLI 


("pttp pxtpnsinn ri pf i n i t imp uninup fnnrtinn nvp rl nad O nui nprnnpt H'artivpr Ip traitpmpnt Hvnaminup Hp*; attrihuts pt 

V_ L III. CALCI lJll/1 1 LI C 1 1 1 1 1 L U 1 1 C LI 1 1 1 LI U C 1 \J 1 1 L. 1 1 \J 1 1 UVCI \ \J C\\A \^ J UUI I J C 1 1 1 1 C L U Cl V. LI V C 1 IC LI CI 1 LC 1 1 IC 1 1 L LIVIICIIIIILILIC UCJ d L LI 1 U LI I J I- L 

des methodes (avec les fonctions set(), get() et call ()). 


nv ri mns 

Uv 1 1 IIIU J 


("pttp pxtpnsinn nprmpt Hp sp rnnnprtpr anx hasps Ovrimns 

V_ Lilt- CALCI IjIUI 1 IJ L 1 1 1 1 C I LI C JL LU 1 1 1 1 CL Id 1 CJUA UGJLJ \J V 1 1 1 1 1 L* 


pcntl 


("pttp pxtpnsinn pst Hpstinpp pn nrinritp anx annliratinns autnnnmps Flip nprmpt Hp rnntrnlpr favpr Hps sinnaux^ nn Hp 

\_CllC CALCI 1 JlL/l 1 Cj I LIC J III 1 CC CI 1 Ul IUI 1 LC QUA a UUI 1 l_Q LIUI | J all Lul lul 1 ICJ. I_l IC IJCI 1 1 1 C I UC CU 1 1 LI L/ICl \<J VCL UCj Jltjl 1 Cl LI A / KJ LI UC 

creer de nouveaux processus (avec fork()). L'ensemble est proche des fonctionnalites equivalentes sous Unix/Linux. 


pcre 


Cette extension dote PHP de fonctions compatibles avec les expressions regulieres Perl. Celles-ci permettent de recher- 
cner des motifs dans les chaines de caracteres. 


pdf 


line deuxieme extension pour creer des documents PDF (fondee sur PDFlib). 


pf pro 


Cette extension permet de traiter les paiements par carte bancaire, a I'aide du service PayFlow de Verisign. 


nn 1 


("pttp pxtpnsinn nprmpt Hp sp rnnnprtpr aux hasps PnstnrpSOl 

V_ L IIL CALCI IJIUI 1 IJC 1 1 1 1 C I UC JC Lv II 1 ICCIC 1 CI LI A UUJCJ 1 L/J LLJ 1 I Jy L_ ■ 


nhn nntinn^/i nfnc 

|_M 1 |J U|J L 1 UN J/ 1 II 1 UJ 


("pttp pxtpnsion rpnrnunp I'pnspmhlp Hps fnnrtinns utilitairps nprmpttant H'affinpr on H'nhtpnir la rnnfinuratinn rnurantp 

LCLIC CA LC 1 1 J) 1 VJ 1 1 1 CUI UUUC 1 CI IJCI 1 IUIC UCJ IUI ILLIUI U LILIIILCIIICJf IJCIIIICLLCIIILLJ QIIIIICI VJ LL LI UU LC Mil Id CUIIIILILJICIl.IL/ll lu LI 1 CI 1 1 LC 

de PHP, notamment la fonction phpinfo(). 


posix 


Cette extension donne acces a l'ensemble des fonctions usuelles definies dans la norme P0SIX.1 , bien connues sous Unix/ 
Linux. 


printer 


Cette extension permet de controler I'impression sous Microsoft Windows. 


nrnn ram PYPrii1""i nn 

IJ I UU 1 dill CACLU L 1 Ul 1 


rottp extension nprmpt H'pxprutpr Hps nrnnrammps loralpmpnt sur Ip sprvpur Hpnuis Ip srrint PHP 

^CLLC tALUIIJIUII UCIIIICl U tAC^Ultl UCJ Ul 1 II 1 ICJ 1 1^1 1 L JUI IC JCI UCUI UCuUIJ IC JCI IUI 1 III. 


pspell 


Cette extension permet de tirer profit de I'outil Aspell et ainsi de verifier I'orthographe d'un mot et eventuellement 
H'nhtpnir Hps sunnpstinns Hp rnrrpctinns 

LI LfL/LCIIM LI CJ JLILJLICJLIUIIJ LIC LUIICCLIUIIJ. 


readline 


readl i ne est une extension simplifiant le traitement des arguments passes en ligne de commande. Cette extension est 
Hnnr ripriipp aux annliratinns autnnnnnps 

LIL/IIL. LI CLI 1 CC Q LI A dUUII^CJLIUIIJ Cl LI LL/I IL/I 1 ICJ. 


recode 


1 'pxtpnsinn rprnHp nprmpt Hp rnnvprtir Hps rhaTnps nu Hps firhiprs H'un pnrnHanp a un autrp II nput ptrp utilp ri'utilispr 

l_ CAICI IJIL/I 1 1 CLUUC UC 1 1 1 1 C I LIC LL/IIVCI Lll LI C J CIIQIIICJ L/LI LICJ IICIIICIJ LI LI 1 1 CI 1 LU LI Cl LI C CI U 1 1 CI LI LI C. II UCUL CLIC LI L 1 1 C LI LILIIIJCI 

iconv ou mstring. 


rpnpxns 

i eye Ap j 


("pttp pxtpnsinn Hpfinit un ipu Hp fnnrtinns sur Hps pxnrpssinns rpnuliprps nrnnrps a PHP II nput ptrp nrpfprahlp H'utilispr 

LCLLC CALCI IJIL/I 1 LICIIIIIL LI 1 1 J C LI LIC 1 U 1 1 C LI U 1 1 J J LI 1 LICJ CAUI CJJlUI IJ ICLILIIICICJ U 1 UU 1 C J CI 1 1 II ■ II UCU L CLIC UICICICIUIC LI LILIIIJCI 

pcre. 


sessi on 


Cette extension regroupe l'ensemble des operations et du support des sessions. 


shmop 


Cette extension permet d'utiliser les fonctionnalites de memoire partagee et de communication interprocessus sur les sys- 
tpmps Unix/I inux 

LCI 1 ICJ Ul 1 1 A/ L_ 1 1 1 LI A. 


ci'mnl p vml 

J 1 Hip 1 C AMI 1 


Altprnativp a ROM SjrnnlpYIVII nprmpt Hp maninnlpr simnlpmpnt Ips Hnnimpnts YMI snns la fnrmp H'unp hiprarrhip 

rAI LCI 1 1 Q LI V C CI L/VJIVI, J 1 1 1 1 Ul C/\l V 1 L IJCIIIICL LIC 1 1 1 C\ 1 1 1 IJ U 1 C 1 J 1 1 1 1 |J 1 C 1 1 1 C 1 1 L ICJ LIUCU 1 1 1 Cl 1 L J /\ 1 V 1 L_ JUUJ 1 CI IL/IIIIC U Lll IC 1 1 1 Cl O 1 L.I 1 1 C 

d'objets. 


snmp 


SNMP (Simple Network Management Protocol) est, comme son nom I'indique, un protocole utilise pour I'administration 
d'un reseau et sa supervision. 


soap 


Cette extension permet de creer et de gerer des echanges XML conformes a SOAP. 


sockets 


Cette extension permet de manipuler directement les sockets (points de connexion). Dans la plupart des cas, il est possi- 
ble de se contenter des operations sur les flots. 
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spl 


SPL (Standard PHP Library) propose un certain nombre d'interfaces et de design patterns prets a I'emploi dans PHP 5. 


sqlite 


Cette extension permet d'acceder aux bases SQLite. 


streams 


Cette extension regroupe I'ensemble des operations et fonctions permettant de manipuler les flots, qu'il s'agisse de 
fichiers ou de connexions. 


strings 


Cette extension regroupe I'ensemble des fonctions standards agissant sur les chames de caracteres. 


Sybase 


("pttp pytpn<;inn nprmpt H'arrpHpr any ha<;p<; ^\/ha<;p 

V-CllC CALCIIJIUII IJCIIIICL <J QLLCUCI QUA UQjCj Jyuajc 


sybase_ct 


Cette extension permet d'acceder aux bases Sybase (variante CT). 


tidy 


Tidy est un analyseur de code HTML. Rigoureux, il met en evidence les non-conformites et peut reformuler le code, en 
tenant compte des standards a respecter. 


tokenizer 


Cette extension permet d'acceder au cceur de I'analyseur de code inclus dans I'interpreteur PHP. Cela permet d'analyser 
soi-meme un code PHP de maniere tres simple (pour generer de la documentation ou des statistiques). 


unified odbc 


Cette extension n'est pas reellement une interface vers ODBC, mais une interface native vers des systemes de gestion de 
bases de donnees dont I'interface de programmation est compatible avec ODBC. II est toutefois possible, en plus de ces 

ha<;p<; rl'i itilkpr rppllpmpnt ODRf si I'nn aim itp lp nilntp i nrl hr 

UQjCj, U UIIIIjCI 1 CCI 1 CI 1 1 CI 1 1 \JWU\- -> 1 1 Ull C1JUUIC IC UIIUIC 1 ULIUK_. 


url 


Cette extension regroupe I'ensemble des fonctions agissant sur les URL. 


variables 


Cette extension regroupe I'ensemble des fonctions permettant de manipuler ou d'obtenir des informations sur les varia- 
bles PHP et leur contenu. 


w32api 


Cette extension, reservee aux systemes sous Microsoft Windows, permet d'utiliser directement depuis PHP les fonctions 

c;tanHarH<; Hpfinipc; riant; I'intprfarp Win39 

3 Lai iuui uj uc i 1 1 1 ic j uai d i iii lci i ai_c v v 1 1 uz. . 


wddx 


WDDX p^t un nrntnrnlp nni nnrmali<;p <;nii<; fnrmp tpxtnpllp (XMI \ un rnntpnu Hp maniprp h Ip tran^nnrtpr Qanc Hpnprrli- 

v v u lj /\ cjl u i i Lri u iuv_uic uui 1 1 yji i 1 1 a i ijc juuj i ui i i ic lcaluci 1 C \/\l V 1 [_/ U 1 1 \-\J\ 1 LCI 1 U , UC 1 1 \o 1 1 1 C 1 c a IC 11 C! 1 1 J IJ\J\ LCI JCll I J UCUCIUI 

tion sur le reseau. 


xml 


Cette extension permet d'analyser un document XML. Les possibility offertes sont de plus bas niveau que celles propo- 
sees par DOM. 


Yfnl rnr 

AMI 1 1 \J ^_ 


("pttp PYtprKinn nprmpt H'invnmipr Hp*; nrnrpHnrp<; a Hktanrp pn prhannpant Ip<; Hnnnpp<; <;niK fnrmp Hp Hnmmpnt<; XMI 

\_CllC CALCI 1 _> 1 \J 1 1 [J CI IIICL U 1 1 1 V UU LI CI UCJ [J 1 UV-CU U 1 C J O KA 1 J LCI 1 H_C CI 1 Cl_l 1 CI 1 IUCC1I 11 ICJ UUI 1 1 ICC J JUUJ IUIIIIC UC UUI.U 1 1 1 CI 1 LJ /\l V 1 L. 


xsl 


Cette extension permet de realiser les transformations XSL de documents XML depuis PHP. 


yaz 


Cette extension permet d'utiliser les outils yaz et d'interroger les serveurs conformes a la norme ANSI Z39.50 


yp 


Sous Unix/Linux, NIS (autrefois appele YP pour Yellow Pages) est le systeme historique d'annuaires utilisables pour I'iden- 
tification, la resolution des noms etdes groupes d'individus (a la maniere d'un Active Directory sous Microsoft Windows). 
Cette extension permet d'acceder a ces annuaires. 


zlib 


Cette extension permet de manipuler ou d'acceder a des documents compresses avec gzip de maniere transparente avec 
la plupart des operations sur les fichiers. 
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Pear (PHP Extension and Application 
Repository) 

On le voit, le nombre d'extensions compatibles avec PHP est impression- 
nant. En realite, le manuel en ligne de PHP en integre davantage. Cepen- 
dant l'arrivee de PHP 5 est l'occasion de rationaliser l'explosion du nombre 
de ces extensions. 

Desormais, seul le noyau dur des extensions PHP sera inclus dans la distri- 
bution PHP, le reste residant dans une sorte de gigantesque bibliotheque. 
Cette bibliotheque est Pear. 

A l'origine, Pear n'est qu'un repertoire de petits modules, souvent des classes 
realisees par des developpeurs ou des utilisateurs de PHP et mises en 
commun pour la communaute des utilisateurs. 

Depuis ses modestes debuts, Pear a beaucoup evolue et se transforme de plus 
en plus en un equivalent de CPAN, qui est la source de reference pour les 
modules Perl. 

Pear propose done une multitude de composants qui peuvent vous eviter de 
reinventer la roue. A ceci s'ajoutent done depuis PHP 5 les extensions qui, 
sans etre inutiles, repondent a des besoins plus specifiques que ceux de la 
distribution. 

Enfin, la force de Pear est de disposer d'un installeur simple d'emploi. Pour 
disposer d'une extension ou d'un composant, inutile de recompiler PHP, il 
suffit de demander, et l'installeur Pear s'occupe de tout. 

Aussi, quels que soient vos objectifs, il ne faut pas hesiter a explorer la base 
Pear. Certes, Pear est encore en cours de murissement et tous les composants 
n'ont pas la maturite attendue, mais on aurait tort de mettre l'ensemble de 
Pear de cote, alors que celui-ci a fini par revetir une importance capitale au 
sein de la strategic PHP. 



Document Object p 
Model (DOM) L 



La representation des documents avec 
DOM 

Lorsqu'un document doit etre analyse chacun est libre de choisir a la fois la 
methode mise en oeuvre, et la facon de stocker en memoire le resultat de 
l'analyse realisee. 

A l'echelle du Web cette liberte confine au chaos en matiere de developpe- 
ment. Le W3C a done propose un modele permettant de representer et 
manipuler les documents XML et HTML. Ce modele se nomme DOM. 

DOM ne prejuge en rien de la methode utilisee pour analyser un document 
mais se contente de definir une interface et un modele de representation des 
informations qui devra etre accessible via l'interface. 

Le modele propose par DOM repose sur une representation arborescente de 
la structure des documents analyses. C'est cette representation arborescente 
qui devra etre manipulable via l'interface de programmation. 

Cependant chaque developpeur reste libre de stocker l'information comme 
bon lui semble (une liste chainee par exemple) tant que l'implantation de 
l'interface respecte DOM et expose a l'utilisateur la representation arbores- 
cente definie dans la recommandation. Que celle-ci colle a l'implantation ou 
pas n'a aucune importance pour l'utilisateur de DOM. 



La recommandation off icielle du W3C et le copyright associe 

Dans cette annexe nous allons reprendre la specification en IDL (Interface Definition Language) de I'API Document Object 
Model (DOM) Level 3 Core (Annexe F). 

Ces elements, dont certains sont traduits en francais, ne sauraient etre confondus avec la recommandation off icielle qui 
demeure la seule reference, telechargeable librement sur les sites precises ci-dessous. 

Pour chaque interface la mention suivante est applicable : 

/* 

* Copyright (c) 2004 World Wide Web Consortium, 

* 

* (Massachusetts Institute of Technology, European Research Consortium for 

* Informatics and Mathematics, Keio University). All Rights Reserved. This 

* work is distributed under the W3C(r) Software License [1] in the hope that 

* it will be useful, but WITHOUT ANY WARRANTY; without even the implied 

* warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 

* [1] http://www.w3. org/Consorti urn/Legal /2002/copy right- software-2002 12 31 

V 

Par ailleurs, le lecteur est invite a prendre connaissance du texte integral de la licence mentionnee : 
W3C® SOFTWARE NOTICE AND LICENSE 

http://www.w3 .org/Consorti urn/Legal /2002/copy right- software-2002 12 31 

This work (and included software, documentation such as READMEs, or other related items) is being provided by the 
copyright holders under the following license. By obtaining, using and/or copying this work, you (the licensee) 
agree that you have read, understood, and will comply with the following terms and conditions. 
Permission to copy, modify, and distribute this software and its documentation, with or without modification, for 
any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies 
of the software and documentation or portions thereof, including modifications: 

1. The full text of this NOTICE in a location viewable to users of the redistributed or derivative work. 

2. Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the 
W3C Software Short Notice should be included (hypertext is preferred, text is permitted) within the body of any 
redistributed or derivative code. 

3. Notice of any changes or modifications to the files, including the date changes were made. (We recommend 
you provide URIs to the location from which the code is derived.) 

THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, 
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR 
PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, 
TRADEMARKS OR OTHER RIGHTS. 

COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF 
ANY USE OF THE SOFTWARE OR DOCUMENTATION. 

The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the 
software without specific, written prior permission. Title to copyright in this software and any associated 
documentation will at all times remain with copyright holders. 



► http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/ 

► http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/idl/dom.idl 
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Types elementaires 



Au-dela des noeuds qui, dans une representation arborescente vont constituer l'essentiel des objets manipules, DOM 
definit quelques types elementaires, et en realite un type cle : DOMString. 

Nombre de methodes dans l'API DOM vont manipuler des chaines de caracteres. Pour s'assurer la plus large audience, 
DOM utilise l'encodage UTF-16 pour chaque caractere (qui occupe done 2 octets). Ce type de caracteres est desormais 
tres bien supporte par la plupart des langages, y compris JavaScript. 

Par ailleurs DOM propose les types suivants : 

• DOMTimeStamp pour stocker une date (absolue ou relative). Celle-ci est exprimee en millisecondes ; 

• DOMUserData qui permet de lier une arborescence DOM a des donnees utilisateurs exterieures a l'arbre. Ce type de don- 
nee represente un pointeur generique ; 

• DOMObject pour manipuler des references d'objets DOM. 



Interfaces fondamentales 



DOM dispose d'implantations dans 
de nombreux langages, PHP naturel- 
lement mais aussi Java et JavaScript 
entre autres. Le modele objet netant 
pas necessairement supporte par tous 
ces langages, l'API DOM ne definit 
pas des objets mais des interfaces. 
Naturellement dans le cas des lan- 
gages orientes objet, on definira le 
plus souvent une hierarchie de classes 
coherente avec celles des interfaces 
DOM. 



Node 



DOMStringList 



NameList 



NameList 



DOMImplementationList 



DOMImplementationSource 



DOMImplementation 



NodeList 



Named NodeMap 



Type Info 



UserDataHandler 



DOMError 



DOMErrorHandler 



DOMLocator 



DOMConfiguration 



Document 



DocumentFragment 



Charade rData 



Attr 



Element 



DocumentType 



Notation 



Entity 



EntityReference 



Processing Instruction 



Comment 



Text 



CDATASection 
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COMPRENDRE L'OMG IDL 



Dans la suite les interfaces de programmation 
DOM ne seront pas decrites en utilisant la syntaxe 
de PHP. En effet PHP n'etant pas un langage forte- 
ment type, nos descriptions ne seraient pas assez 
precises. Toutefois le langage retenu, issu des tra- 
vaux de I'OMG (Object Management Group) et de 
CORBA ne devrait pas poser probleme. 
► http://www.omg.org/technology/documents/ 
formal/corba 2.htm 



Dans l'absolu, l'interface Node est la plus importante et est suffisante pour 
tout faire. Cependant, dans la pratique on utilisera des interfaces plus 
sophistiquees en fonction de la nature du noeud manipule comme Element ou 
Document. 

Enfin, il faut noter que DOM est aujourd'hui disponible dans sa troisieme 
mouture, certains attributs ou methodes sont done apparus au fil du temps, 
dans les versions deux ou trois, ces evolutions sont precisees dans les inter- 
faces qui suivent. 



Pour plus de details 

Cette annexe reprend les interfaces de I'API DOM de maniere succinte. Dans la plupart des cas, les 
noms des methodes et des attributs sont caracteristiques du role de chacun et se suffisent a eux- 
memes. 

Toutefois, certaines interfaces peuvent necessiter des explications approfondies. Le plus sage est 
alors de revenir a la recommandation qui explicite pour chaque attribut ou methode le role et les 
contraintes. 

> http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/ 



DOMException 

En cas d'echec, lors de situations exceptionnelles, les methodes de l'API DOM peuvent etre amenees a declencher une 
exception. DOM ne definit qu'une exception : DOMExeption (en PHP cette classe derive naturellement de la classe 
Exception). 

Toutefois l'implantation est libre de declencher des erreurs additionnelles. En outre, les langages non orientes objet peu- 
vent se contenter d'utiliser le mecanisme traditionnel de traitement des erreurs a base de code de retour. 

exception DOMException { 
unsigned short code; 

}; 



Tableau C-1 Constantes definies dans DOM (niveau 1) 



Nom 


Valeur 


Signification 


INDEX_SIZE_ERR 


1 


Index ou intervalle invalide. 


DOMSTRINC_SIZE_ERR 


2 


Le texte propose n'est pas stockable dans la chaTne. 


HIERARCHY_REQUEST_ERR 


3 


Nceud impossible a inserer a cet endroit. 


WRONC_DOCUMENT_ERR 


4 


Nceud utilise dans un document incompatible. 


INVALID_CHARACTER_ERR 


5 


Caractere invalide (par exemple dans un nom d'element). 


NO_DATA_ALLOWED_ERR 


6 


Aucune donnee ne peut etre inseree. 


NO_MODIFICATION_ALLOWED_ERR 


7 


Modification interdite 


N0T_F0UND_ERR 


8 


Noeud introuvable dans ce contexte. 


NOT_SUPPORTED_ERR 


9 


Fonctionnalite non prise en charge par l'implantation. 


INUSE_ATTRIBUTE_ERR 


10 


Ajout d'un attribut deja associe a un element par ailleurs. 



250 



Tableau C-2 Constantes definies dans DOM (niveau 2) 



NOIT1 


Valeur 


Signification 


INVALID_STATE_ERR 


11 


L'objet n'est plus utilisable. 


SYNTAX_ERR 


12 


La chaine manipulee est erronnee. 


INVALID_MODIFICATION_ERR 


13 


Modification du type de l'objet interdite. 


NAMESPACE_ERR 


14 


Modification apportee a l'objet non conforme aux contraintes de I'espace de noms. 


INVALIDJ\CCESS_ERR 


15 


Parametre ou methode non pris en charge. 




Tableau C-3 


Constantes definies dans DOM (niveau 3) 


Nom 


Valeur 


Signification 


VALIDATION_ERR 


16 


Le noeud est invalide apres utilisation de i nsertBefore() ou removeChild(). 


TYPE_MISMATCH_ERR 


17 


Type d'objet non conforme a celui attendu. 



DOMStringList- DOM® 

Cette interface decrit la manipulation d'une liste de chaines de caracteres. La taille de la liste est disponible via l'attribut 
length et chaque chaine peut etre obtenue individuellement avec la fonction item(). 

interface DOMStringList { 
readonlyattribute unsigned long length; 

DOMString item (in unsigned long index); 

boolean contains (in DOMString str); 

}; 



NameList- DOM® 

L'utilisation de listes dans DOM est assez frequente, en PHP cela peut paraitre deroutant tant la notion de tableau est 
riche. Ici il s'agit de manipuler une liste ordonnee de couples : nom , espace de noms. 

interface NameList { 

readonly attribute unsigned long length; 

DOMString getName (in unsigned long index); 

DOMString getNamespaceURI (in unsigned long index); 

boolean contains (in DOMString str); 

boolean containsNS (in DOMString namespaceURI , 

in DOMString name) ; 

}; 



DOMImplementation 

L'interface DOMImplementation permet de creer ou de manipuler des informations transversales independantes des docu- 
ments manipules par ailleurs. 
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En outre, l'interface DOMImplementation permet de s'assurer de la disponibilite de certaines fonctionnalites dans l'implanta- 
tion DOM utilisee. 

interface DOMImplementation { 

boolean hasFeature (in DOMString feature, 

in DOMString version); 

// Methodes disponibles a compter de DOM niveau 2 : 

DocumentType createDocumentType(in DOMString qualifiedName, 

in DOMString publicld, 

in DOMString systemld) raises(DOMException) ; 

Document createDocument (in DOMString namespaceURI , 

in DOMString qua! if iedName, 

in DocumentType doctype) raises(DOMException) ; 

// Methodes disponibles a compter de DOM niveau 3 : 

DOMObject getFeature (in DOMString feature, 

in DOMString version); 

}; 



DOMImplementationSource 

Dans le prolongement de l'interface DOMImplementation, DOMImplementationSource permet d'obtenir une ou plusieurs 
implantations compatibles avec certaines fonctionnalites minimales. 

interface DOMImplementationSource { 
DOMImplementation getDOMImplementation (in DOMString features); 
DOMImplementationLi st getDOMImplementationList (in DOMString features); 

}; 



DOMImplementationList 

Encore une liste, mais consacree aux objets DOMImplementation, et notamment utilisee dans le cadre de 
DOMImpl ementati onSou rce. 

interface DOMImplementationList { 

readonly attribute unsigned long length; 
DOMImplementation item(in unsigned long index); 

}; 



Node 

L'interface Node est naturellement l'interface fondamentale de l'API DOM. Elle fournit les fonctions essentielles pour 
parcourir et manipuler l'arbre representant chaque document analyse. 

interface Node { 

readonly attribute DOMString nodeName; 

attribute DOMString nodeValue; 

// 1 'affectation et la lecture peuvent lever une 
// exception DOMException 
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o 



readonly att 
readonly att 
readonly att 
readonly att 
readonly att 
readonly att 
readonly att 
readonly att 
// Attributs 
readonly att 
// Attributs 
readonly att 
att 

readonly att 
// Attributs 
readonly att 
att 



ribute unsigned short nodeType; 



parentNode; 

childNodes; 

firstChild; 

lastChild; 

previousSibling; 

nextSibling; 

attributes; 



ribute Node 
ribute NodeList 
ribute Node 
ribute Node 
ribute Node 
ribute Node 
ribute NamedNodeMap 
modifies pour DOM niveau 2 
ribute Document ownerDocument; 
disponibles compter de DOM niveau 2 
ribute DOMString namespaceURI; 
ribute DOMString prefix; 

// 1 'affectation peut lever une exception DOMException 
ribute DOMString local Name; 

disponibles compter de DOM niveau 3 



o 

I 



ribute DOMString 
ribute DOMString 



boolean 
Node 

// Methodes 
Node 

Node 

Node 
Node 
void 

// Methodes 
boolean 

boolean 



hasChi ldNodes 
cloneNode 
modifiees pour DOM niveau 3 
insertBefore 

replaceChild 

removeChild 
appendChild 
normal ize 



baseURI; 
textContent; 

// 1 'affectation et la lecture peuvent lever une 
// exception DOMException 

0; 

(in boolean deep) ; 



(in Node newCh 

in Node refCh 

(in Node newCh 

in Node oldCh 

(in Node oldCh 



Id, 



Id) rai ses (DOMException) ; 
Id, 

Id) rai ses (DOMException) 

Id) rai ses (DOMException) 

(in Node newChild) rai ses (DOMException) 

0; 



disponibles a compter de DOM niveau 2 

isSupported (in DOMString feature, 

in DOMString version); 
hasAttri butes () ; 



// Methodes disponibles a compter de DOM niveau 3 



unsigned short 

boolean 

DOMString 

boolean 

DOMString 

boolean 

DOMObject 

DOMUserData 



DOMUserData 



compareDocumentPosi ti on 

isSameNode 

lookupPref ix 

i sDef aul tNamespace 

lookupNamespaceURI 

isEqualNode 

getFeature 

setUserData 



getUserData 



(in Node other) rai ses (DOMException) ; 

(in Node other) ; 

(in DOMString namespaceURI); 

(in DOMString namespaceURI); 

(in DOMString prefix); 

(in Node arg) ; 

(in DOMString feature, 

in DOMString version); 

(in DOMString key, 

in DOMUserData data, 

in UserDataHandler handler); 

(in DOMString key) ; 



}; 
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Tableau C-4 Constantes associees aux differents types de noeuds DOM 



Type 




tLtMtN 1 _NUUt 


I 


A 1 1 KIdU 1 t_NUUt 


I 


1 tA 1 _NUUt 


5 


LUA 1 A_i>tL 1 l(JN_NUUt 


4 


tN 1 1 1 Y_KtrtKtNLt_NUUt 


C 
J 


tN 1 1 1 Y_NUUb 


r 
0 


rKULb:>blN(j_lN;> 1 KUL 1 lUN_NUUb 


7 


C0MMENT_N0DE 


8 


D0CUMENT_N0DE 


9 


DOCUMENT_TYPE_NODE 


10 


DOCUMENT_FRACMENT_NODE 


11 


N0TATI0N_N0DE 


12 


Tableau C-5 


Nom 


Valeur associee 


DOCUMENT_POSITION_DISCONNECTED 


0x01 


DOCUMENT_POSITlON_PRECEDING 


0x02 


D0CUMENT_P0SITI0N_F0LL0WINC 


0x04 


DOCUMENT_POSITION_CONTAINS 


0x08 


DOCUMENT_POSITION_CONTAINED_BY 


0x10 


D0CUMENT_P0SITI0OMPLEMENTATI0N_SPECIFIC 


0x20 



NodeList 

NodeList definit une liste ordonnee de noeuds. Ce type de liste est souvent utilisee comme valeur de retour par les 
methodes DOM. 

interface NodeList { 
Node item(in unsigned long index); 

readonly attribute unsigned long length; 

}; 
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Document 



Autre interface fondamentale de DOM, Document etend l'interface Node pour proposer des methodes de plus au niveau 
(comme la creation d'elements ou de sections Text). 



interface 
readonly 
readonly 
// Attri 
readonly 
// Attri 
readonly 
readonly 



Document : 
attri bute 
attri bute 
buts modifi 
attribute 
buts dispon 
attri bute 
attri bute 
attri bute 



Node { 

DOMImpl ementati on i mpl ementat i on ; 
Element documentElement; 

es pour DOM niveau 3 



attribute DOMString 



attri bute 
attri bute 

readonly attribute 

Element 

DocumentFragment 
Text 
Comment 
CDATASecti on 
Processi nglnstructi 

Attr 

Entity Reference 
NodeLi st 

// Methodes disponi 
Node 

Element 

Attr 

NodeLi st 

Element 

// Methodes disponi 
Node 
void 
Node 



DocumentType doctype; 
ibles a compter de DOM niveau 3 
DOMString i nputEncodi ng ; 

DOMString xml Encoding; 

boolean xml Standalone; 

// 1 'affectation 
xmlVersion; 
// 1 'affectation 
boolean strictErrorChecki 
DOMString documentURI; 
DOMConfiguration domConfig; 
createElement 
createDocument Fragment 
createTextNode 
createComment 
createCDATASection 
on createProcessi nglnstructi on (in 

in 

createAttribute 
createEnti tyReference 
getElementsByTagName 
bles a compter de DOM niveau 
importNode 



peut lever une exception DOMException 

peut lever une exception DOMException 
ng; 



(in 

0; 

(in 
(in 
(in 



(in 
(in 
(in 



createElementNS 
createAttri buteNS 
getElementsByTagNameNS 
getElementByld 

bles a compter de DOM niveau 

adoptNode 

normal izeDocument 

renameNode 



(in 
in 
(in 
in 
(in 
in 
(in 
in 
(in 
i : 
(in 

0; 

(in 
in 
in 



}; 



DOMString tagName) raises (DOMException) ; 

DOMString data) ; 
DOMString data) ; 

DOMString data) rai ses(DOMException) ; 
DOMString target, 

DOMString data) rai ses(DOMException) ; 
DOMString name) rai ses(DOMException) ; 
DOMString name) rai ses(DOMException) ; 
DOMString tagname); 

Node importedNode, 

boolean deep) rai ses(DOMException) ; 

DOMString namespaceURI, 

DOMString qualifiedName) rai ses(DOMException) ; 
DOMString namespaceURI, 

DOMString qualifiedName) rai ses(DOMException) ; 
DOMString namespaceURI, 
DOMString local Name); 
DOMString elementld); 

Node source) raises (DOMException) ; 

Node n, 

DOMString namespaceURI, 

DOMString qualifiedName) rai ses(DOMException) ; 



DocumentFragment 

L'interface DocumentFragment permet de manipuler des morceaux de document. II serait bien sur possible d'utiliser l'inter- 
face Document classique. Cependant, en fonction de l'implantation, celle-ci peut s'averer gourmande en ressources. 
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DocumentFragrent laisse done a l'implantation la possibilite de proposer une version allegee, utilisee specifiquement pour 
composer des morceaux de documents entre eux. 

Cette interface ne definit aucune methode complementaire a celles definies dans l'interface Node, 
interface DocumentFragment : Node { 

}; 



Named NodeMap 

Outre les listes, qui permettent d'acceder a des collections d'objets ordonnes, l'interface NamedNodeMap permet de mani- 
puler une collection de noeuds en proposant un acces par leur nom (y compris l'espace de noms). 

interface NamedNodeMap { 

readonly attribute unsigned long length; 

Node getNamedltem (in DOMString name); 

Node setNamedltem (in Node arg) raises(DOMException) ; 

Node removeNamedltem (in DOMString name) raises(DOMException) ; 

Node item (in unsigned long index); 

// Methodes disponibles a compter de DOM niveau 2 

Node getNamedltemNS (in DOMString namespaceURI , 

in DOMString local Name) rai ses(DOMException) ; 

Node setNamedltemNS (in Node arg) raises(DOMException) ; 

Node removeNamedltemNS (in DOMString namespaceURI, 

in DOMString local Name) rai ses(DOMException) ; 

}; 



CharacterData 

CharacterData represente une interface qu'on pourrait qualifier d'abstraite. En effet, dans un document DOM aucun 
nceud de ce type n'existe. Par contre, cette interface sera completee de maniere a definir les interfaces Text et Comment 
notamment. 



interface CharacterData : Node { 
attribute DOMString 



readonly attribute unsigned long 



DOMString 

void 
void 

void 

void 



substringData 

appendData 
insertData 

deleteData 

replaceData 



data; 

// 1 'affectation et la lecture peuvent lever une 

// exception DOMException 

length; 

(in unsigned long offset, 

in unsigned long count) rai ses (DOMException) ; 
(in DOMString arg) rai ses(DOMException) ; 
(in unsigned long offset, 

in DOMString arg) rai ses(DOMException) ; 
(in unsigned long offset, 

in unsigned long count) rai ses (DOMException) ; 
(in unsigned long offset, 
in unsigned long count, 
in DOMString arg) rai ses(DOMException) ; 
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o 
o 

Attr | 

■G 

Cette interface permet de manipuler les proprietes d'un nceud correspondant a un attribut dans le document original. |r 

c 

interface Attr : Node { 1 
readonly attribute DOMString name; g 

readonly attribute boolean specified; ° 

attribute DOMString value; u 

// 1 'affectation peut lever une exception DOMException 
// Attributs disponibles a parti r de DOM niveau 2 
readonly attribute Element ownerElement; 
// Attributs disponibles a parti r de DOM niveau 3 
readonly attribute Typelnfo schemaTypelnfo; 
readonly attribute boolean isld; 



Element 



Cette interface etend l'interface Node de maniere a proposer des fonctions de plus haut niveau pour les noeuds qui s'averent 
etre des elements dans le document original. 



interface Element : Node { 

readonly attribute DOMString tagName; 
DOMString getAttribute(in DOMString name); 

// Attributs disponibles a parti r de DOM niveau 3 
readonly attribute Typelnfo schemaTypelnfo; 



void 

void 
Attr 
Attr 
Attr 
NodeList 



setAttri bute 



(in DOMString name, 

in DOMString value) raises(DOMException) ; 
(in DOMString name) rai ses (DOMException) ; 
(in DOMString name); 
(in Attr newAttr) rai ses(DOMException) ; 
removeAttributeNode (in Attr oldAttr) rai ses (DOMException) ; 
getElementsByTagName (in DOMString name); 



removeAttribute 
getAttri buteNode 
setAttri buteNode 



// Methodes disponibles a compter de DOM n 

( 



DOMString 
void 

void 

Attr 

Attr 
NodeList 

boolean 
boolean 



getAttri buteNS 
setAttri buteNS ( 

removeAttri buteNS ( 

getAttri buteNodeNS ( 

setAttri buteNodeNS ( 
getElementsByTagNameNS( 



hasAttri bute 
hasAttri buteNS 



iveau 2 

in DOMString namespaceURI, 

in DOMString localName) rai ses (DOMException) ; 

in DOMString namespaceURI, 

in DOMString qualifiedName, 

in DOMString value) rai ses (DOMException) ; 

in DOMString namespaceURI, 

in DOMString localName) rai ses (DOMException) ; 

in DOMString namespaceURI, 

in DOMString localName) rai ses (DOMException) ; 

in Attr newAttr) rai ses (DOMException) ; 

in DOMString namespaceURI, 

in DOMString localName) rai ses (DOMException) ; 

in DOMString name) ; 

in DOMString namespaceURI, 

in DOMString localName) rai ses (DOMException) ; 
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// Methodes disponibles a compter de DOM niveau 3 



void 
void 

void 



setldAttri bute 
setldAttributeNS 

setldAttri buteNode 



(in DOMString name, 

in boolean isld) raises(DOMException) ; 

(in DOMString namespaceURI, 

in DOMString local Name, 

in boolean isld) raises(DOMException) ; 

(in Attr idAttr, 

in boolean isld) raises(DOMException) ; 



Text 

Cette interface permet de manipuler les contenus texte des elements d'un document. 

interface Text : CharacterData { 

// Attributs disponibles a partir de DOM niveau 3 

readonly attribute boolean i sElementContentWhitespace ; 

readonly attribute DOMString wholeText; 

// Methodes disponibles a compter de DOM niveau 3 : 

Text splitText (in unsigned long offset) rai ses(DOMException) ; 
Text replaceWholeText (in DOMString content) raises(DOMException) ; 

}; 



Comment 

interface Comment : CharacterData { 

}; 



Typelnfo- DOM® 

L'interface Typelnfo permet de manipuler les types associes aux attributs ou elements lorsqu'un schema est associe au 
document analyse. 

interface Typelnfo { 

readonly attribute DOMString typeName; 

readonly attribute DOMString typeNamespace; 

boolean isDerivedFrom(in DOMString typeNamespaceArg, 

in DOMString typeNameArg, 

in unsigned long derivationMethod) ; 

}; 





Valeur 


DERIVATIONLRESTRICTION 


0x00000001 


DERIVATIONLEXTENSION 


0x00000002 


DERIVATIONJJNION 


0x00000004 


DERIVATIONLLIST 


0x00000008 
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UserDataHandler- DOM® 



On a vu avec le type DOMUserData que l'API DOM permet d'associer a un noeud une reference vers des informations 
externes. Cette interface permet de definir un handler qui sera invoque en cas de clonage, renommage ou importantion et 
plus generalement une modification sur un noeud comportant une donnee utilisateur. 



interface UserDataHandler { 



void 



handle( 



in unsigned short operation, 

in DOMString key, 

in DOMUserData data, 

in Node src, 

i n Node dst) ; 



Tableau C-6 Types d'operation definis 



Nom 


Valeur 


N0DE_CL0NED 


1 


N0DE_IMP0RTED 


2 


NODE_DELETED 


3 


NODE_RENAMED 


4 


N0DE_AD0PTED 


5 



DOMError- DOM® 

Cette interface decrit une erreur au sein de l'API DOM. 



interface DOMError { 

readonly attribute unsigned short severity; 



}; 



readonly attribute DOMString 

readonly attribute DOMString 

readonly attribute DOMObject 

readonly attribute DOMObject 

readonly attribute DOMLocator 



message ; 
type; 

relatedException; 

relatedData; 

location; 



Tableau C-7 Niveaux d'erreur definis 



Nom 


Valeur 


SEVERITY_WARNINC 


1; 


SEVERITY_ERROR 


2; 


SEVERITY_FATAL_ERROR 


3; 
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DOMErrorHandler- DOM® 

Cette interface decrit un handler qui pourra etre appele automatiquement par l'implantation DOM en cas d'erreur. 

interface DOMErrorHandler { 

bool icin handl eEr ro r(i n DOMError error) j 

}; 

DOMLocator- DOM® 

Toujours dans le cadre du traitement des erreurs cette interface permet de determiner une position dans un document, 
notamment le lieu d'une erreur. 

interface DOMLocator { 
readonly attribute long 
readonly attribute long 
readonly attribute long 
readonly attribute long 
readonly attribute Node 
readonly attribute DOMString 

}; 

DOMConfiguration- DOM® 

DOMConfiguration definit une interface permettant d'obtenir et de modifier les parametres d'analyse propres a un docu- 
ment donne. 

interface DOMConfiguration { 

readonly attribute DOMStringList parameterNames; 

void setParameter (in DOMString name, 

in DOMUserData value) rai ses(DOMException) ; 

DOMUserData getParameter (in DOMString name) raises(DOMException) ; 

boolean canSetParameter (in DOMString name, 

in DOMUserData value) ; 

}; 



lineN umber; 
col umnNumber; 
byteOffset; 
utfl60ffset; 
relatedNode; 
uri ; 
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Interfaces etendues pour XML 

L'API DOM est utilisable tant pour les documents HTML que les documents XML. Les interfaces suivantes permettent 
de manipuler plus precisement des nceuds specifiques aux documents XML. 

CDATASection 

Une section CDATA dans un document XML permet de manipuler du texte qui ne respecte pas la syntaxe XML (par 
exemple un extrait de code ou du HTML mal forme). 

interface CDATASection : Text { 

}; 



DocumentType 

Cette interface permet de manipuler la definition de type d'un document XML. 

interface DocumentType : Node { 

readonly attribute DOMString name; 

readonly attribute NamedNodeMap entities; 
readonly attribute NamedNodeMap notations; 

// Attributs disponibles a parti r de DOM niveau 2 
readonly attribute DOMString publicld; 
readonly attribute DOMString systemld; 

readonly attribute DOMString i nternalSubset; 

}; 



Notation 

Cette interface est utilisee pour obtenir la notation associee a une DTD. 

interface Notation : Node { 

readonly attribute DOMString publicld; 

readonly attribute DOMString systemld; 

}; 
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Entity 

Cette interface permet d'obtenir le detail d'une entite dans un document (par exemple & ou ´ 

interface Entity : Node { 

readonly attribute DOMString publicld; 

readonly attribute DOMString systemld; 

readonly attribute DOMString notationName; 
// Attributs disponibles a parti r de DOM niveau 3 

readonly attribute DOMString i nputEncodi ng ; 

readonly attribute DOMString xml Encodi ng ; 

readonly attribute DOMString xmlVersion; 

}; 



EntityReference 

interface EntityReference : Node { 

}; 



Processinglnstruction 

Cette interface permet d'obtenir ou de modifier le code d'une instruction de traitement. Ainsi cette interface pourrait per- 
mettre d'obtenir le code PHP enfoui dans un document HTML ou XML. 



i nte rf ace Processi nglnstructi on 
readonly attribute DOMString 
attribute DOMString 



}; 



Node { 
target; 
data; 

// 1 'affectation peut lever une exception DOMException 
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Organisation du code 
de PHP Saloon 

Pour simplifier la comprehension du code de PHP Saloon, celui-ci est orga- 
nise de la maniere la plus simple possible autour de poles homogenes. Ainsi 
l'ensemble du code associe au rendu de l'application a ete place dans le 
repertoire styl e. 

L'arborescence retenue est decrite ci-dessous. 



Repertoire 


Role 




Racine du code de PHP Saloon. 


./img 


L'ensemble des images utilisees dans PHP Saloon sont deposees dans ce repertoire. 


./img/connectes 


Photos des connectes. 


./inc 


Ensemble des composants de PHP Saloon et notamment les classes communes. 


./inc/i 


Interfaces des classes utilisees. 


./style 


Ce repertoire regroupe l'ensemble des feuilles de styles utilisees pour le rendu du code XML. 


./style/xul 


Transformations XSL et elements XUL pour le rendu Mozilla/Gecko. 


./styl e/chtml 


Transformations XSL et code cHTML pour la plate-forme i-mode. 


./styl e/chtml /page 




./styl e/chtml /form 




./styl e/html 


Transformations XSL et code HTML pour les navigateurs standards. 


./styl e/html/fo rm 




./styl e/html /page 




./xml 


Modeles XML utilises notamment pour I'inscription et I'identification. 


■ /sql 


Code SQL permettant de creer le schema initial de la base. 


L'integralite du code est disponible sur le site www.stephanemariel.com et l'appli- 
cation PHP Saloon est utilisable en ligne sur le site www.phpsaloon.com. 
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De la conception a I'exploitation, on creera une application de discussion en ligne en 
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On verra dans ce cahier comment concevoir le code d'une application web en utilisant 
les interfaces, comment prototyper un modele de donnees dans SQLite, internationaliser 
un site dynamique grace a Apache et PHP, generer des rendus en fonction du client 
(XUL/Mozilla, i-mode) avec les transformations XSLT, optimiser le code et les perfor- 
mances par les inclusions et compressions a la volee... 
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